├── LICENSE
├── README.md
├── control-wp-core-emails.php
├── lib
    ├── global.php
    └── settings.php
├── readme.txt
└── screenshot-1.png


/LICENSE:
--------------------------------------------------------------------------------
 1 | The MIT License (MIT)
 2 | 
 3 | Copyright (c) 2016 Andrew Norcross
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 | 
23 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | Control WP Core Emails
 2 | ======================
 3 | 
 4 | **Contributors:** norcross
 5 | 
 6 | **Donate link:** http://andrewnorcross.com/donate
 7 | 
 8 | **Tags:** email, core
 9 | 
10 | **Requires at least:** 4.0
11 | 
12 | **Tested up to:** 4.6
13 | 
14 | **Stable tag:** 0.0.1
15 | 
16 | 
17 | ### Description ###
18 | 
19 | Control the emails sent by the WordPress auto-update process. Disable which update result(s) are excluded from email sending.
20 | 
21 | 
22 | ### Installation ###
23 | 
24 | This section describes how to install the plugin and get it working.
25 | 
26 | 1. Upload `control-wp-core-emails` to the `/wp-content/plugins/` directory.
27 | 1. Activate the plugin through the 'Plugins' menu in WordPress.
28 | 1. Go to the General Settings section and choose the emails to suppress.
29 | 
30 | ### Frequently Asked Questions ###
31 | 
32 | #### Why do I need this? ####
33 | 
34 | Maybe you don't. But this is for people who don't want emails sent on site updates. It can get sort of unruly when you have a lot of sites. And because emails are annoying.
35 | 
36 | #### I would like to edit what the update email contains. Can I do that? ####
37 | 
38 | Probably, but not with this plugin. This is *only* intended to suppress the emails sent, not modify them in any way.
39 | 
40 | #### I have a question / bug report / feature request ####
41 | 
42 | Best place for them is on [Github](https://github.com/norcross/control-wp-core-emails/).
43 | 
44 | 
45 | ### Screenshots ###
46 | 
47 | ![Settings Page](https://raw.githubusercontent.com/norcross/control-wp-core-emails/master/screenshot-1.png?raw=true "Settings Page")
48 | 
49 | 
50 | ### Changelog ###
51 | 
52 | **0.0.1**
53 | * Initial release
54 | 
55 | 
56 | ### Upgrade Notice ###
57 | 
58 | **0.0.1**
59 | Initial release
60 | 


--------------------------------------------------------------------------------
/control-wp-core-emails.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * Plugin Name: Control WP Core Emails
 4 |  * Plugin URI: https://github.com/norcross/control-wp-core-emails
 5 |  * Description: Fine tune the emails sent by WP core.
 6 |  * Author: Andrew Norcross
 7 |  * Author URI: http://reaktivstudios.com/
 8 |  * Version: 0.0.1
 9 |  * Text Domain: control-wp-core-emails
10 |  * Domain Path: languages
11 |  * License: MIT
12 |  * GitHub Plugin URI: https://github.com/norcross/control-wp-core-emails
13 |  */
14 | 
15 | // Set my base for the plugin.
16 | if ( ! defined( 'CONTROL_WP_CORE_EMAILS_BASE' ) ) {
17 | 	define( 'CONTROL_WP_CORE_EMAILS_BASE', plugin_basename( __FILE__ ) );
18 | }
19 | 
20 | // Set my directory for the plugin.
21 | if ( ! defined( 'CONTROL_WP_CORE_EMAILS_DIR' ) ) {
22 | 	define( 'CONTROL_WP_CORE_EMAILS_DIR', plugin_dir_path( __FILE__ ) );
23 | }
24 | 
25 | // Set my version for the plugin.
26 | if ( ! defined( 'CONTROL_WP_CORE_EMAILS_VER' ) ) {
27 | 	define( 'CONTROL_WP_CORE_EMAILS_VER', '0.0.1' );
28 | }
29 | 
30 | /**
31 |  * Set up and load our class.
32 |  */
33 | class ControlCoreEmails
34 | {
35 | 
36 | 	/**
37 | 	 * Load our hooks and filters.
38 | 	 *
39 | 	 * @return void
40 | 	 */
41 | 	public function init() {
42 | 		add_action( 'plugins_loaded',               array( $this, 'textdomain'          )           );
43 | 		add_action( 'plugins_loaded',               array( $this, 'load_files'          )           );
44 | 	}
45 | 
46 | 	/**
47 | 	 * Load textdomain for international goodness.
48 | 	 *
49 | 	 * @return textdomain
50 | 	 */
51 | 	public function textdomain() {
52 | 		load_plugin_textdomain( 'control-wp-core-emails', false, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );
53 | 	}
54 | 
55 | 	/**
56 | 	 * Call our files in the appropriate place.
57 | 	 *
58 | 	 * @return void
59 | 	 */
60 | 	public function load_files() {
61 | 
62 | 		// Load our global file.
63 | 		require_once( 'lib/global.php' );
64 | 
65 | 		// Load our settings file.
66 | 		if ( is_admin() ) {
67 | 			require_once( 'lib/settings.php' );
68 | 		}
69 | 	}
70 | 
71 | 	// End the class.
72 | }
73 | 
74 | // Instantiate our class.
75 | $ControlCoreEmails = new ControlCoreEmails();
76 | $ControlCoreEmails->init();
77 | 


--------------------------------------------------------------------------------
/lib/global.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * Control WP Core Emails - Global Module
 4 |  *
 5 |  * Contains the overall global functions to use.
 6 |  *
 7 |  * @package Control WP Core Emails
 8 |  */
 9 | 
10 | /**
11 |  * Set up and load our class.
12 |  */
13 | class ControlCoreEmails_Global
14 | {
15 | 
16 | 	/**
17 | 	 * Load our hooks and filters.
18 | 	 *
19 | 	 * @return void
20 | 	 */
21 | 	public function init() {
22 | 		add_filter( 'auto_core_update_send_email',  array( $this, 'control_core_emails' ),  10, 4   );
23 | 	}
24 | 
25 | 	/**
26 | 	 * Filters whether to send an email following an automatic background core update.
27 | 	 *
28 | 	 * @param bool   $send         Whether to send the email. Default true.
29 | 	 * @param string $type         The type of email to send. Can be one of 'success', 'fail', 'critical'.
30 | 	 * @param object $core_update  The update offer that was attempted.
31 | 	 * @param mixed  $result       The result for the core update. Can be WP_Error.
32 | 	 *
33 | 	 * @return bool   $send         Whether to send the email.
34 | 	 */
35 | 	public function control_core_emails( $send, $type, $core_update, $result ) {
36 | 
37 | 		// Fetch our stored settings data, and return true if nothing is checked.
38 | 		if ( false === $stored = self::get_stored_settings() ) {
39 | 			return true;
40 | 		}
41 | 
42 | 		// If we have a type, and it's one of the ones we set, then bypass the email.
43 | 		return ! empty( $type ) && in_array( $type, $stored ) ? false : true;
44 | 	}
45 | 
46 | 	/**
47 | 	 * Get our stored setting data.
48 | 	 *
49 | 	 * @param  string $key      The option key.
50 | 	 *
51 | 	 * @return array  The stored settings, or false if none exist.
52 | 	 */
53 | 	public static function get_stored_settings( $key = 'core-control-emails' ) {
54 | 
55 | 		// Bail without a key.
56 | 		if ( empty( $key ) ) {
57 | 			return false;
58 | 		}
59 | 
60 | 		// Fetch the option.
61 | 		$option = get_option( $key );
62 | 
63 | 		// Return the option data or false.
64 | 		return ! empty( $option ) ? $option : false;
65 | 	}
66 | 
67 | 	// End class.
68 | }
69 | 
70 | // Instantiate our class.
71 | $ControlCoreEmails_Global = new ControlCoreEmails_Global();
72 | $ControlCoreEmails_Global->init();
73 | 


--------------------------------------------------------------------------------
/lib/settings.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * Control WP Core Emails - Settings Module
  4 |  *
  5 |  * Contains the specific settings page configuration
  6 |  *
  7 |  * @package Control WP Core Emails
  8 |  */
  9 | 
 10 | /**
 11 |  * Set up and load our class.
 12 |  */
 13 | class ControlCoreEmails_Settings
 14 | {
 15 | 
 16 | 	/**
 17 | 	 * Load our hooks and filters.
 18 | 	 *
 19 | 	 * @return void
 20 | 	 */
 21 | 	public function init() {
 22 | 		add_action( 'admin_init',                   array( $this, 'load_settings'       )           );
 23 | 	}
 24 | 
 25 | 	/**
 26 | 	 * Register our new settings and load our settings fields.
 27 | 	 *
 28 | 	 * @return void
 29 | 	 */
 30 | 	public function load_settings() {
 31 | 
 32 | 		// Register our setting for emails.
 33 | 		register_setting( 'general', 'core-control-emails', array( $this, 'data_sanitize' ) );
 34 | 
 35 | 		// And create our settings section.
 36 | 		add_settings_section( 'core-control-emails', '', array( $this, 'settings' ), 'general' );
 37 | 	}
 38 | 
 39 | 	/**
 40 | 	 * Our settings section.
 41 | 	 *
 42 | 	 * @param  array $args  The arguments from the add_settings_section call.
 43 | 	 */
 44 | 	public function settings( $args ) {
 45 | 
 46 | 		// Fetch our stored settings data.
 47 | 		$stored     = ControlCoreEmails_Global::get_stored_settings();
 48 | 
 49 | 		// Parse each one.
 50 | 		$success    = in_array( 'success', $stored ) ? 'checked="checked"' : '';
 51 | 		$manual     = in_array( 'manual', $stored ) ? 'checked="checked"' : '';
 52 | 		$fail       = in_array( 'fail', $stored ) ? 'checked="checked"' : '';
 53 | 		$critical   = in_array( 'critical', $stored ) ? 'checked="checked"' : '';
 54 | 
 55 | 		// Add a div to wrap our whole thing for clean.
 56 | 		echo '<div class="' . esc_attr( $args['id'] ) . '-wrap">';
 57 | 
 58 | 		// Now set up the table with each value.
 59 | 		echo '<table id="' . esc_attr( $args['id'] ) . '" class="core-control-emails-settings-table form-table">';
 60 | 		echo '<tbody>';
 61 | 
 62 | 			echo '<tr>';
 63 | 
 64 | 				// The field label.
 65 | 				echo '<th scope="row">';
 66 | 					echo '<label>' . esc_html__( 'Update Emails', 'control-wp-core-emails' ) . '</label>';
 67 | 				echo '</th>';
 68 | 
 69 | 				// The input field.
 70 | 				echo '<td>';
 71 | 
 72 | 					echo '<label for="core-control-email-success">';
 73 | 					echo '<input type="checkbox" id="core-control-email-success" name="core-control-emails[]" value="success" ' . $success  . ' />';
 74 | 					echo ' ' . esc_html__( 'Success', 'control-wp-core-emails' ) . '</label>';
 75 | 
 76 | 					echo '<br>';
 77 | 
 78 | 					echo '<label for="core-control-email-manual">';
 79 | 					echo '<input type="checkbox" id="core-control-email-manual" name="core-control-emails[]" value="manual" ' . $manual  . ' />';
 80 | 					echo ' ' . esc_html__( 'Manual', 'control-wp-core-emails' ) . '</label>';
 81 | 
 82 | 					echo '<br>';
 83 | 
 84 | 					echo '<label for="core-control-email-fail">';
 85 | 					echo '<input type="checkbox" id="core-control-email-fail" name="core-control-emails[]" value="fail" ' . $fail  . ' />';
 86 | 					echo ' ' . esc_html__( 'Failure', 'control-wp-core-emails' ) . '</label>';
 87 | 
 88 | 					echo '<br>';
 89 | 
 90 | 					echo '<label for="core-control-email-critical">';
 91 | 					echo '<input type="checkbox" id="core-control-email-critical" name="core-control-emails[]" value="critical" ' . $critical  . ' />';
 92 | 					echo ' ' . esc_html__( 'Critical', 'control-wp-core-emails' ) . '</label>';
 93 | 
 94 | 					echo '<br>';
 95 | 
 96 | 					// Add our intro content.
 97 | 					echo '<p class="description">' . esc_html__( 'Select the notification emails you want to suppress.', 'control-wp-core-emails' ) . '</p>';
 98 | 
 99 | 				echo '</td>';
100 | 
101 | 			echo '</tr>';
102 | 
103 | 		// Close the table.
104 | 		echo '</tbody>';
105 | 		echo '</table>';
106 | 	}
107 | 
108 | 	/**
109 | 	 * Sanitize the user data inputs.
110 | 	 *
111 | 	 * @param  array $input  The data entered in a settings field.
112 | 	 *
113 | 	 * @return array $input  The sanitized data.
114 | 	 */
115 | 	public function data_sanitize( $input ) {
116 | 
117 | 		// Make sure we have an array.
118 | 		$input  = (array) $input;
119 | 
120 | 		// Set an empty array.
121 | 		$data   = array();
122 | 
123 | 		// Loop and sanitize each item.
124 | 		foreach ( $input as $single ) {
125 | 			$data[] = sanitize_key( $single );
126 | 		}
127 | 
128 | 		// And send it back.
129 | 		return $data;
130 | 	}
131 | 
132 | 	// End class.
133 | }
134 | 
135 | // Instantiate our class.
136 | $ControlCoreEmails_Settings = new ControlCoreEmails_Settings();
137 | $ControlCoreEmails_Settings->init();
138 | 


--------------------------------------------------------------------------------
/readme.txt:
--------------------------------------------------------------------------------
 1 | === Control WP Core Emails ===
 2 | Contributors: norcross
 3 | Website Link: http://andrewnorcross.com/plugins/
 4 | Donate link: https://andrewnorcross.com/donate
 5 | Tags: emails, core updates
 6 | Requires at least: 4.0
 7 | Tested up to: 4.6
 8 | Stable tag: 0.0.1
 9 | License: MIT
10 | License URI: http://norcross.mit-license.org/
11 | 
12 | Control the emails sent by the WordPress auto-update process.
13 | 
14 | == Description ==
15 | 
16 | Control the emails sent by the WordPress auto-update process. Disable which update result(s) are excluded from email sending.
17 | 
18 | == Installation ==
19 | 
20 | This section describes how to install the plugin and get it working.
21 | 
22 | 1. Upload `control-wp-core-emails` to the `/wp-content/plugins/` directory.
23 | 1. Activate the plugin through the 'Plugins' menu in WordPress.
24 | 1. Go to the General Settings section and choose the emails to suppress.
25 | 
26 | == Frequently Asked Questions ==
27 | 
28 | = Why do I need this? =
29 | 
30 | Maybe you don't. But this is for people who don't want emails sent on site updates. It can get sort of unruly when you have a lot of sites. And because emails are annoying.
31 | 
32 | = I would like to edit what the update email contains. Can I do that? =
33 | 
34 | Probably, but not with this plugin. This is *only* intended to suppress the emails sent, not modify them in any way.
35 | 
36 | = I have a question / bug report / feature request =
37 | 
38 | Best place for them is on [Github](https://github.com/norcross/control-wp-core-emails).
39 | 
40 | == Screenshots ==
41 | 
42 | 1. Screenshot
43 | 
44 | 
45 | == Changelog ==
46 | 
47 | = 0.0.1 - 2016/09/14 =
48 | * First release!
49 | 
50 | 
51 | == Upgrade Notice ==
52 | 
53 | = 0.0.1 =
54 | * First release!
55 | 


--------------------------------------------------------------------------------
/screenshot-1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/norcross/control-wp-core-emails/59167f452f1f44a4c643c49f6b194c8e41465b7a/screenshot-1.png


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