├── inc
    └── widget-snpe.php
├── js
    └── snpe-widget.js
├── readme.txt
└── simple-new-post-emails.php


/inc/widget-snpe.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * Widget class.
 4 |  */
 5 | class SNPE_Widget extends WP_Widget {
 6 | 	public function __construct() {
 7 | 		$widget_ops = array( 'classname' => 'snpe-widget', 'description' => 'Allow a user to sign up for simple new post emails.' );
 8 | 		parent::__construct( 'snpe-widget', 'Simple New Post Emails', $widget_ops );
 9 | 	}
10 | 
11 | 	public function widget( $args, $instance ) {
12 | 		// Currently only on for logged in users
13 | 		if ( ! is_user_logged_in() ) {
14 | 			return;
15 | 		}
16 | 
17 | 		wp_enqueue_script( 'snpe-widget', plugins_url( 'js/snpe-widget.js', dirname( __FILE__ ) ), array( 'jquery' ), '0.1', true );
18 | 
19 | 		wp_localize_script( 'snpe-widget', 'snpe_vars', array( 'ajaxurl' => admin_url( 'admin-ajax.php', 'relative' ) ) );
20 | 
21 | 		$user = wp_get_current_user();
22 | 
23 | 		$title = empty( $instance['title'] ) ? 'New Post Emails' : $instance['title'];
24 | 
25 | 		echo $args['before_widget'];
26 | 		echo $args['before_title'] . $title . $args['after_title'];
27 | ?>
28 | <form name="snpe_options" class="snpe-options">
29 | 	<p>
30 | 		<label for="snpe_send">
31 | 			<input name="snpe_send" type="checkbox" id="snpe_send" value="Y"<?php checked( $user->snpe_send, 'Y' ); ?> />
32 | 			<span class="spinner" style="display:none;width:20px;height:20px;background:url(<?php echo includes_url( '/images/spinner-2x.gif' ); ?>) no-repeat center;background-size:20px 20px">&nbsp;</span>
33 | 			Email me when a new post is published
34 | 		</label>
35 | 	</p>
36 | 
37 | 	<input type="hidden" name="action" value="snpe-options-save" />
38 | 	<?php wp_nonce_field( 'snpe-options-save' ); ?>
39 | </form>
40 | <?php
41 | 		echo $args['after_widget'];
42 | 	}
43 | 
44 | 	public function update( $new_instance, $old_instance ) {
45 | 		$instance = $old_instance;
46 | 		$instance['title'] = wp_strip_all_tags( $new_instance['title'] );
47 | 		return $instance;
48 | 	}
49 | 
50 | 	public function form( $instance ) {
51 | 		$instance = wp_parse_args( (array) $instance, array( 'title' => '' ) );
52 | 		$title = strip_tags( $instance['title'] );
53 | ?>
54 | <p>
55 | 	<label for="<?php echo $this->get_field_id( 'title' ); ?>"><?php _e('Title:'); ?></label>
56 | 	<input class="widefat" id="<?php echo $this->get_field_id( 'title' ); ?>" name="<?php echo $this->get_field_name( 'title' ); ?>" type="text" value="<?php echo esc_attr( $title ); ?>" />
57 | </p>
58 | <?php
59 | 	}
60 | }
61 | 


--------------------------------------------------------------------------------
/js/snpe-widget.js:
--------------------------------------------------------------------------------
 1 | (function($){
 2 | 	var snpe_send = function(e){
 3 | 		var $this = $(this),
 4 | 			checked = ! $this.prop('checked'), // store the previous state
 5 | 			spinner = $(this).siblings('.spinner');
 6 | 
 7 | 		$this.off('change');
 8 | 		$this.hide();
 9 | 		spinner.css( 'display', 'inline-block' );
10 | 
11 | 		$.ajax({
12 | 			type: 'POST',
13 | 			dataType: 'json',
14 | 			url: snpe_vars.ajaxurl,
15 | 			data: $('.snpe-options').serialize(),
16 | 			success: function(r) {
17 | 				if ( true === r.success ) {
18 | 					$this.prop( 'checked', r.data );
19 | 				} else {
20 | 					$this.prop( 'checked', checked);
21 | 				}
22 | 
23 | 				spinner.hide();
24 | 				$this.show();
25 | 				$this.on('change', snpe_send);
26 | 			}
27 | 		});
28 | 	};
29 | 
30 | 	$('#snpe_send').on('change', snpe_send);
31 | })(jQuery);
32 | 


--------------------------------------------------------------------------------
/readme.txt:
--------------------------------------------------------------------------------
 1 | === Simple New Post Emails ===
 2 | Contributors: 10up, helen, chrishardie
 3 | Tags: email, post emails, intranet
 4 | Requires at least: 3.0
 5 | Tested up to: 5.9
 6 | Requires PHP:
 7 | Stable tag: 0.7.1
 8 | License: GPLv2 or later
 9 | License URI: http://www.gnu.org/licenses/gpl-2.0.html
10 | 
11 | Allow site members to check a box and get new posts via email. Includes a widget.
12 | 
13 | == Description ==
14 | 
15 | Allow site members to check a box and get new posts via email. The checkbox appears on the user's profile, as well as an optional widget for your site. Works especially well for intranet sites.
16 | 
17 | = Contributing =
18 | 
19 | Pull requests and issues on [GitHub](https://github.com/10up/simple-new-post-emails) welcome.
20 | 
21 | == Installation ==
22 | 
23 | Simple New Post Emails is most easily installed automatically via the Plugins tab in your dashboard. If other WordPress emails do not send from your installation, neither will these.
24 | 
25 | == Frequently Asked Questions ==
26 | 
27 | = Where are all the configuration options? =
28 | 
29 | The premise of this plugin is to keep things as simple as possible, particularly in the UI and UX. There are many other great plugins available that provide more functionality (typically with the cost of a more complex user experience), as well as email newsletter services. Some configuration is possible via hooks. If a hook isn't available to accomplish what you need, please [open an issue on GitHub](https://github.com/10up/simple-new-post-emails/issues).
30 | 
31 | == Screenshots ==
32 | 
33 | 1. User profile option
34 | 2. Widget in Twenty Eleven
35 | 
36 | == Changelog ==
37 | 
38 | = 0.7.1 =
39 | * **Added:** Plugin banner and icon (props [@lea10up](https://profiles.wordpress.org/lea10up/)).
40 | * **Added:** GitHub Actions for WordPress.org plugin deploy and readme/asset update (props [@jeffpaul](https://profiles.wordpress.org/jeffpaul/), [@ChrisHardie](https://profiles.wordpress.org/chrishardie/)).
41 | * **Changed:** Bump WordPress version "tested up to" 5.6 (props [@ChrisHardie](https://profiles.wordpress.org/chrishardie/)).
42 | * **Changed:** Documentation updates (props [@jeffpaul](https://profiles.wordpress.org/jeffpaul/)).
43 | 
44 | = 0.7 =
45 | * Fix: mail delivery was failing silently in default configuration
46 | 
47 | = 0.6 =
48 | * Add a column to the users admin list (props @chrishardie)
49 | * Update deprecated function calls (props @chrishardie)
50 | 
51 | = 0.5 =
52 | * Initial release
53 | 


--------------------------------------------------------------------------------
/simple-new-post-emails.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * Plugin Name:       Simple New Post Emails
  4 |  * Plugin URI:        https://github.com/10up/simple-new-post-emails
  5 |  * Description:       Allow site members to check a box and get new posts via email. Includes a widget.
  6 |  * Version:           0.7.1
  7 |  * Requires at least: 3.0
  8 |  * Requires PHP:
  9 |  * Author:            10up
 10 |  * Author URI:        https://10up.com
 11 |  * License:           GPL v2 or later
 12 |  * License URI:       https://www.gnu.org/licenses/gpl-2.0.html
 13 |  */
 14 | 
 15 | /*
 16 | Copyright 2013 10up
 17 | 
 18 | This program is free software; you can redistribute it and/or modify
 19 | it under the terms of the GNU General Public License as published by
 20 | the Free Software Foundation; either version 2 of the License, or
 21 | (at your option) any later version.
 22 | 
 23 | This program is distributed in the hope that it will be useful,
 24 | but WITHOUT ANY WARRANTY; without even the implied warranty of
 25 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 26 | GNU General Public License for more details.
 27 | 
 28 | You should have received a copy of the GNU General Public License
 29 | along with this program; if not, write to the Free Software
 30 | Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 31 | */
 32 | 
 33 | class Simple_New_Post_Emails {
 34 | 	/**
 35 | 	 * Set up hooks.
 36 | 	 */
 37 | 	public function __construct() {
 38 | 		require_once( 'inc/widget-snpe.php' );
 39 | 
 40 | 		add_action( 'widgets_init', array( $this, 'widgets_init' ) );
 41 | 		add_action( 'personal_options', array( $this, 'personal_options' ) );
 42 | 		add_action( 'edit_user_profile_update', array( $this, 'option_save' ) );
 43 | 		add_action( 'personal_options_update', array( $this, 'option_save' ) );
 44 | 		add_action( 'wp_ajax_snpe-options-save', array( $this, 'ajax_option_save' ) );
 45 | 		add_action( 'publish_post', array( $this, 'publish_post' ), 10, 2 );
 46 | 		add_filter( 'manage_users_columns', array( $this, 'add_snpe_user_column') );
 47 | 		add_action( 'manage_users_custom_column', array( $this, 'show_snpe_user_column_content'), 10, 3 );
 48 | 	}
 49 | 
 50 | 	/**
 51 | 	 * Register the widget.
 52 | 	 * @return null
 53 | 	 */
 54 | 	public function widgets_init() {
 55 | 		register_widget( 'SNPE_Widget' );
 56 | 	}
 57 | 
 58 | 	/**
 59 | 	 * Add the setting to the user profile page.
 60 | 	 * @param  WP_User $user User object.
 61 | 	 * @return null
 62 | 	 */
 63 | 	public function personal_options( $user ) {
 64 | ?>
 65 | <tr class="snpe-option">
 66 | 	<th scope="row">New Post Emails</th>
 67 | 	<td>
 68 | 		<label for="snpe_send">
 69 | 			<input name="snpe_send" type="checkbox" id="snpe_send" value="Y"<?php checked( $user->snpe_send, 'Y' ); ?> />
 70 | 			Email me when a new post is published
 71 | 		</label>
 72 | 	</td>
 73 | </tr>
 74 | <?php
 75 | 	}
 76 | 
 77 | 	/**
 78 | 	 * Save our custom profile option.
 79 | 	 * @param  int $user_id User ID
 80 | 	 * @return bool         Whether or not the option was successfully saved.
 81 | 	 */
 82 | 	public function option_save( $user_id ) {
 83 | 		if ( ! current_user_can( 'edit_user', $user_id ) ) {
 84 | 			return false;
 85 | 		}
 86 | 
 87 | 		if ( isset( $_POST['snpe_send'] ) && 'Y' === $_POST['snpe_send'] ) {
 88 | 			return update_user_meta( $user_id, 'snpe_send', 'Y' );
 89 | 		} else {
 90 | 			return delete_user_meta( $user_id, 'snpe_send' );
 91 | 		}
 92 | 	}
 93 | 
 94 | 	/**
 95 | 	 * Save our profile option on Ajax.
 96 | 	 * @return null
 97 | 	 */
 98 | 	public function ajax_option_save() {
 99 | 		check_admin_referer( 'snpe-options-save' );
100 | 
101 | 		$user = wp_get_current_user();
102 | 		if ( ! $this->option_save( $user->ID ) ) {
103 | 			wp_send_json_error();
104 | 		}
105 | 
106 | 		$data = isset( $_POST['snpe_send'] ) ? true : false;
107 | 		wp_send_json_success( $data );
108 | 	}
109 | 
110 | 	/**
111 | 	 * Fire off emails if this is the first publish.
112 | 	 * @param  int     $post_id Post ID.
113 | 	 * @param  WP_Post $post    Post object.
114 | 	 * @return null
115 | 	 */
116 | 	public function publish_post( $post_id, $post ) {
117 | 		// We've already sent an email for this before, so bail.
118 | 		if ( 'Y' === get_post_meta( $post_id, 'snpe_sent', true ) ) {
119 | 			return;
120 | 		}
121 | 
122 | 		$sent = false;
123 | 
124 | 		// Note: we do not escape anything in the subject line, allowing PHPMailer to handle.
125 | 		$subject = '[' . get_bloginfo( 'name' ) . '] ' . $post->post_title;
126 | 
127 | 		$message = '<html><body>';
128 | 		$message .= '<h3><a href="' . get_permalink( $post_id ) . '">' . $post->post_title . '</a></h3>';
129 | 		$message .= wpautop( wptexturize( wp_kses_post( strip_shortcodes( $post->post_content ) ) ) );
130 | 		$message .= '<hr /><p>Posted by <a href="' . get_author_posts_url( $post->post_author ) . '">' . get_the_author_meta( 'display_name', $post->post_author ) . '</a>.</p>';
131 | 		$message .= '<p>View the post and comments at <a href="' . get_permalink( $post_id ) . '">' . get_permalink( $post_id ) . '</a>.</p>';
132 | 		$message .= '</body></html>';
133 | 
134 | 		// Get the users who want emails
135 | 		$users = get_users( array( 'meta_key' => 'snpe_send' ) );
136 | 
137 | 		$subject = apply_filters( 'snpe_subject', $subject, $post );
138 | 		$message = apply_filters( 'snpe_message', $message, $post );
139 | 		$users = apply_filters( 'snpe_users', $users, $post );
140 | 
141 | 		if ( empty( $users ) ) {
142 | 			return;
143 | 		}
144 | 
145 | 		$sent = $this->send_mail( $users, $subject, $message, $post );
146 | 
147 | 		if ( $sent ) {
148 | 			update_post_meta( $post_id, 'snpe_sent', 'Y' );
149 | 		}
150 | 	}
151 | 
152 | 	private function send_mail( $users, $subject, $message, $post ) {
153 | 		// BCC all users specified
154 | 		$headers = array();
155 | 
156 | 		foreach ( (array) $users as $user ) {
157 | 			$headers[] = 'Bcc: ' . $user->user_email;
158 | 		}
159 | 
160 | 		$headers[] = "Content-Type: text/html; charset=utf-8\r\n";
161 | 		$headers = apply_filters( 'snpe_headers', $headers, $post, $users );
162 | 
163 | 		// Get the site domain and get rid of www.
164 | 		// Borrowed from wp-includes/pluggable.php
165 | 		$sitename = strtolower( $_SERVER['SERVER_NAME'] );
166 | 		if ( substr( $sitename, 0, 4 ) == 'www.' ) {
167 | 			$sitename = substr( $sitename, 4 );
168 | 		}
169 | 
170 | 		$to = apply_filters( 'snpe_to_email', 'wordpress@' . $sitename, $post );
171 | 
172 | 		return wp_mail( $to, $subject, $message, $headers );
173 | 	}
174 | 
175 | 	/**
176 | 	 * Add a column to the Users admin table indicating subscription status
177 | 	 * @param array $columns    User table columns
178 | 	 *
179 | 	 * @return array
180 | 	 */
181 | 	public function add_snpe_user_column( $columns ) {
182 | 		$columns['snpe_send'] = 'Email New Posts?';
183 | 		return $columns;
184 | 	}
185 | 
186 | 	/**
187 | 	 * Return a user-friendly string based on the value of the user meta field
188 | 	 * @param string $value Passed column value
189 | 	 * @param string    $column_name    Passed column name
190 | 	 * @param int   $user_id    User ID
191 | 	 *
192 | 	 * @return string
193 | 	 */
194 | 	public function show_snpe_user_column_content( $value, $column_name, $user_id ) {
195 | 		$snpe_send = get_user_meta( $user_id, 'snpe_send', true );
196 | 		if ( 'snpe_send' == $column_name ) {
197 | 			return ( true == $snpe_send ) ? 'Yes' : 'No';
198 | 		}
199 | 		return $value;
200 | 	}
201 | }
202 | 
203 | $simple_new_post_emails = new Simple_New_Post_Emails();
204 | 


--------------------------------------------------------------------------------