Send a synchronous XML-RPC subscribe to blog posts or subscribe to post comments request.
| public subscribe ( string $email, array $post_ids, boolean $async = true, $extra_data = [] ) : true | Jetpack_Error | ||
| string | ||
| $post_ids | array | (optional) defaults to 0 for blog posts only: array of post IDs to subscribe to blog's posts |
| $async | boolean | (optional) Should the subscription be performed asynchronously? Defaults to true. |
| return | true | Jetpack_Error | true on success invalid_email : not a valid email address invalid_post_id : not a valid post ID unknown_post_id : unknown post not_subscribed : strange error. Jetpack servers at WordPress.com could subscribe the email. disabled : Site owner has disabled subscriptions. active : Already subscribed. unknown : strange error. Jetpack servers at WordPress.com returned something malformed. unknown_status : strange error. Jetpack servers at WordPress.com returned something I didn't understand. |
/**
* Check Jetpack Subscription
* @since 1.0.5
* @version 1.0
*/
protected function check_jetpack_subscription($email = NULL, $post_ids = NULL)
{
if ($email === NULL) {
return 'missing';
}
if (!class_exists('Jetpack') && defined('JETPACK__PLUGIN_DIR')) {
require_once JETPACK__PLUGIN_DIR . 'jetpack.php';
}
if (!class_exists('Jetpack_Subscriptions') && defined('JETPACK__PLUGIN_DIR')) {
require_once JETPACK__PLUGIN_DIR . 'modules/subscriptions.php';
}
if ($post_ids === NULL) {
$subscribe = Jetpack_Subscriptions::subscribe($email, 0, false);
} else {
$subscribe = Jetpack_Subscriptions::subscribe($email, $post_ids, false);
}
if (is_wp_error($subscribe)) {
$error = $subscribe->get_error_code();
} else {
$error = false;
foreach ($subscribe as $response) {
if (is_wp_error($response)) {
$error = $response->get_error_code();
break;
}
}
}
if ($error) {
switch ($error) {
case 'invalid_email':
$return = 'invalid';
break;
case 'active':
$return = 'active';
break;
case 'pending':
$return = 'pending';
break;
default:
$return = '';
break;
}
} else {
if (is_array($subscribe) && $subscribe[0] === true) {
$error = true;
}
$return = 'pending';
}
if ($error) {
return $return;
}
return 'new';
}
/**
* Jetpack_Subscriptions::comment_subscribe_init()
*
* When a user checks the comment subscribe box and submits a comment, subscribe them to the comment thread.
*/
function comment_subscribe_submit($comment_id, $approved)
{
if ('spam' === $approved) {
return;
}
// Set cookies for this post/comment
$this->set_cookies(isset($_REQUEST['subscribe_comments']), isset($_REQUEST['subscribe_blog']));
if (!isset($_REQUEST['subscribe_comments']) && !isset($_REQUEST['subscribe_blog'])) {
return;
}
$comment = get_comment($comment_id);
$post_ids = array();
if (isset($_REQUEST['subscribe_comments'])) {
$post_ids[] = $comment->comment_post_ID;
}
if (isset($_REQUEST['subscribe_blog'])) {
$post_ids[] = 0;
}
Jetpack_Subscriptions::subscribe($comment->comment_author_email, $post_ids, true, array('source' => 'comment-form', 'widget-in-use' => is_active_widget(false, false, 'blog_subscription', true) ? 'yes' : 'no', 'comment_status' => $approved, 'server_data' => $_SERVER));
}
/**
* Jetpack_Subscriptions::comment_subscribe_init()
*
* When a user checks the comment subscribe box and submits a comment, subscribe them to the comment thread.
*/
function comment_subscribe_submit($comment_id, $approved)
{
if ('spam' === $approved) {
return;
}
// Set cookies for this post/comment
$this->set_cookies(isset($_REQUEST['subscribe_comments']), isset($_REQUEST['subscribe_blog']));
if (!isset($_REQUEST['subscribe_comments']) && !isset($_REQUEST['subscribe_blog'])) {
return;
}
$comment = get_comment($comment_id);
$post_ids = array();
if (isset($_REQUEST['subscribe_comments'])) {
$post_ids[] = $comment->comment_post_ID;
}
if (isset($_REQUEST['subscribe_blog'])) {
$post_ids[] = 0;
}
Jetpack_Subscriptions::subscribe($comment->comment_author_email, $post_ids);
}
