Skip to content

Commit

Permalink
Added new link to the plugin details on the main plugin page & confir…
Browse files Browse the repository at this point in the history 
…med WordPress 6.4 compliance.
  • Loading branch information
@KZeni
KZeni committed Oct 24, 2023
1 parent 48a0ac7 commit c396500
Show file tree
Hide file tree
Showing 2 changed files with 156 additions and 55 deletions.
200 changes: 147 additions & 53 deletions disable-theme-plugin-update-emails.php
View file
Original file line number Diff line number Diff line change
Expand Up @@ -6,19 +6,28 @@
* Author: KZeni
* Author URI: https://kzeni.com
* License: GPLv3
* Version: 2.0.4
* Version: 2.0.5
* Requires at least: 5.5
* Tested up to: 6.3
* Tested up to: 6.4
*/

define('KZENI_DISABLE_THEME_PLUGIN_UPDATE_EMAILS_NAME', plugin_basename(__FILE__));
define(
"KZENI_DISABLE_THEME_PLUGIN_UPDATE_EMAILS_NAME",
plugin_basename(__FILE__)
);

// Per https://make.wordpress.org/core/2020/07/30/controlling-plugin-and-theme-auto-update-email-notifications-and-site-health-infos-in-wp-5-5/
// Also see https://gist.github.com/afragen/e2f40ed2e71e590a127e8adc1db05948 where it adds update failure detection
// Disable auto-update email notifications for plugins.
add_filter('auto_plugin_update_send_email', 'kzeni_plugin_theme_update_email_on_failure');
add_filter(
"auto_plugin_update_send_email",
"kzeni_plugin_theme_update_email_on_failure"
);
// Disable auto-update email notifications for themes.
add_filter('auto_theme_update_send_email', 'kzeni_plugin_theme_update_email_on_failure');
add_filter(
"auto_theme_update_send_email",
"kzeni_plugin_theme_update_email_on_failure"
);

/**
* Sends plugin & theme update emails only when at least one plugin/theme update has failed.
Expand All @@ -27,9 +36,17 @@
* @param array $update_results An array of update results.
* @return bool
*/
function kzeni_plugin_theme_update_email_on_failure($enabled, $update_results = array())
{
if (get_option('kzeni_disable_theme_plugin_update_emails_disable_all') === true || get_option('kzeni_disable_theme_plugin_update_emails_disable_all') === 'true') { // If disable failures as well (disable all) is enabled (not the default so just seeing if it's set to true or not is enough to check)
function kzeni_plugin_theme_update_email_on_failure(
$enabled,
$update_results = []
) {
if (
get_option("kzeni_disable_theme_plugin_update_emails_disable_all") ===
true ||
get_option("kzeni_disable_theme_plugin_update_emails_disable_all") ===
"true"
) {
// If disable failures as well (disable all) is enabled (not the default so just seeing if it's set to true or not is enough to check)
return false;
} else {
foreach ($update_results as $update_result) {
Expand All @@ -42,77 +59,154 @@ function kzeni_plugin_theme_update_email_on_failure($enabled, $update_results =
}

// Add options to WordPress' General Settings page
add_action('admin_init', 'kzeni_disable_theme_plugin_update_emails_general_settings_section');
add_action(
"admin_init",
"kzeni_disable_theme_plugin_update_emails_general_settings_section"
);
function kzeni_disable_theme_plugin_update_emails_general_settings_section()
{
add_settings_section(
'kzeni_disable_theme_plugin_update_emails_settings_section', // Section ID
__('Disable Theme and Plugin Auto-Update Emails', 'kzeni_disable_theme_plugin_update_emails'), // Section Title
'kzeni_disable_theme_plugin_update_emails_options_callback', // Callback
'general' // What Page? This makes the section show up on the General Settings Page
"kzeni_disable_theme_plugin_update_emails_settings_section", // Section ID
__(
"Disable Theme and Plugin Auto-Update Emails",
"kzeni_disable_theme_plugin_update_emails"
), // Section Title
"kzeni_disable_theme_plugin_update_emails_options_callback", // Callback
"general" // What Page? This makes the section show up on the General Settings Page
);

add_settings_field( // Option 1
'kzeni_disable_theme_plugin_update_emails_explanation', // Option ID
__('Disable successful update email notifications', 'kzeni_disable_theme_plugin_update_emails'), // Label
'kzeni_disable_theme_plugin_update_emails_field_callback', // !important - This is where the args go!
'general', // Page it will be displayed (General Settings)
'kzeni_disable_theme_plugin_update_emails_settings_section', // Name of our section
array( // The $args
'kzeni_disable_theme_plugin_update_emails_explanation' // Should match Option ID
)
add_settings_field(
// Option 1
"kzeni_disable_theme_plugin_update_emails_explanation", // Option ID
__(
"Disable successful update email notifications",
"kzeni_disable_theme_plugin_update_emails"
), // Label
"kzeni_disable_theme_plugin_update_emails_field_callback", // !important - This is where the args go!
"general", // Page it will be displayed (General Settings)
"kzeni_disable_theme_plugin_update_emails_settings_section", // Name of our section
[
// The $args
"kzeni_disable_theme_plugin_update_emails_explanation", // Should match Option ID
]
);

add_settings_field( // Option 2
'kzeni_disable_theme_plugin_update_emails_disable_all', // Option ID
__('Disable failed update email notifications', 'kzeni_disable_theme_plugin_update_emails'), // Label
'kzeni_disable_theme_plugin_update_emails_field_callback', // !important - This is where the args go!
'general', // Page it will be displayed (General Settings)
'kzeni_disable_theme_plugin_update_emails_settings_section', // Name of our section
array( // The $args
'kzeni_disable_theme_plugin_update_emails_disable_all' // Should match Option ID
)
add_settings_field(
// Option 2
"kzeni_disable_theme_plugin_update_emails_disable_all", // Option ID
__(
"Disable failed update email notifications",
"kzeni_disable_theme_plugin_update_emails"
), // Label
"kzeni_disable_theme_plugin_update_emails_field_callback", // !important - This is where the args go!
"general", // Page it will be displayed (General Settings)
"kzeni_disable_theme_plugin_update_emails_settings_section", // Name of our section
[
// The $args
"kzeni_disable_theme_plugin_update_emails_disable_all", // Should match Option ID
]
);

register_setting('general', 'kzeni_disable_theme_plugin_update_emails_disable_all', '_bool');
register_setting(
"general",
"kzeni_disable_theme_plugin_update_emails_disable_all",
"_bool"
);
}

function kzeni_disable_theme_plugin_update_emails_options_callback()
{ // Section Callback
{
// Section Callback
echo '<a id="disable-theme-plugin-update-emails"></a>';
}

function kzeni_disable_theme_plugin_update_emails_field_callback($args)
{ // Settings Field(s) Callback
if ($args[0] === 'kzeni_disable_theme_plugin_update_emails_explanation') {
echo '<label><input type="checkbox" id="' . $args[0] . '" name="' . $args[0] . '" value="true" checked="checked" disabled="disabled" />';
echo __('Yes, disable <strong><em>successful update</em></strong> email notifications for themes & plugins.', 'kzeni_disable_theme_plugin_update_emails') . '</label>';
echo '<p class="description">' . __('Successful theme & plugin updates won\'t send email notifications simply due to the <strong>Disable Theme and Plugin Auto-Update Emails</strong> plugin being active on this site. Deactivate this plugin if you want to have successful theme & plugin update emails resume sending.', 'kzeni_disable_theme_plugin_update_emails') . '</p>';
{
// Settings Field(s) Callback
if ($args[0] === "kzeni_disable_theme_plugin_update_emails_explanation") {
echo '<label><input type="checkbox" id="' .
$args[0] .
'" name="' .
$args[0] .
'" value="true" checked="checked" disabled="disabled" />';
echo __(
"Yes, disable <strong><em>successful update</em></strong> email notifications for themes & plugins.",
"kzeni_disable_theme_plugin_update_emails"
) . "</label>";
echo '<p class="description">' .
__(
'Successful theme & plugin updates won\'t send email notifications simply due to the <strong>Disable Theme and Plugin Auto-Update Emails</strong> plugin being active on this site. Deactivate this plugin if you want to have successful theme & plugin update emails resume sending.',
"kzeni_disable_theme_plugin_update_emails"
) .
"</p>";
}
if ($args[0] === 'kzeni_disable_theme_plugin_update_emails_disable_all') {
if ($args[0] === "kzeni_disable_theme_plugin_update_emails_disable_all") {
$option = get_option($args[0]);
echo '<label><input type="checkbox" id="' . $args[0] . '" name="' . $args[0] . '" value="true" ';
echo checked($option, 'true');
echo ' /> ';
echo __('Yes, also disable <strong><em>failed update</em></strong> email notifications for themes & plugins.', 'kzeni_disable_theme_plugin_update_emails') . '</label>';
echo '<p class="description">' . __('A theme and/or plugin may fail (or otherwise encounter an issue) when attempting an update, and it\'s typically more important to receieve email notifications for these compared to successful update email notifications. As such, the default is to allow these through while one can choose to disable these as well.', 'kzeni_disable_theme_plugin_update_emails') . '</p>';
echo '<label><input type="checkbox" id="' .
$args[0] .
'" name="' .
$args[0] .
'" value="true" ';
echo checked($option, "true");
echo " /> ";
echo __(
"Yes, also disable <strong><em>failed update</em></strong> email notifications for themes & plugins.",
"kzeni_disable_theme_plugin_update_emails"
) . "</label>";
echo '<p class="description">' .
__(
'A theme and/or plugin may fail (or otherwise encounter an issue) when attempting an update, and it\'s typically more important to receieve email notifications for these compared to successful update email notifications. As such, the default is to allow these through while one can choose to disable these as well.',
"kzeni_disable_theme_plugin_update_emails"
) .
"</p>";
}
}

function kzeni_disable_theme_plugin_update_emails_plugin_extra_links($links, $plugin_name)
{
function kzeni_disable_theme_plugin_update_emails_plugin_extra_links(
$links,
$plugin_name
) {
if ($plugin_name != KZENI_DISABLE_THEME_PLUGIN_UPDATE_EMAILS_NAME) {
return $links;
}
$links[] = '<a href="https://github.com/KZeni/Disable-WordPress-Theme-and-Plugin-Auto-Update-Emails" target="_blank">' . __('GitHub', 'kzeni_disable_theme_plugin_update_emails') . '</a>';
$links[] = '<a href="https://wordpress.org/support/plugin/disable-theme-and-plugin-auto-update-emails/" target="_blank">' . __('Support', 'kzeni_disable_theme_plugin_update_emails') . '</a>';
$links[] =
'<a href="https://github.com/KZeni/Disable-WordPress-Theme-and-Plugin-Auto-Update-Emails" target="_blank">' .
__("GitHub", "kzeni_disable_theme_plugin_update_emails") .
"</a>";
$links[] =
'<a href="https://wordpress.org/support/plugin/disable-theme-and-plugin-auto-update-emails/reviews/" target="_blank">' .
__("Reviews", "kzeni_disable_theme_plugin_update_emails") .
"</a>";
$links[] =
'<a href="https://wordpress.org/support/plugin/disable-theme-and-plugin-auto-update-emails/" target="_blank">' .
__("Support", "kzeni_disable_theme_plugin_update_emails") .
"</a>";
return $links;
}
add_filter('plugin_row_meta', 'kzeni_disable_theme_plugin_update_emails_plugin_extra_links', 10, 2);
add_filter(
"plugin_row_meta",
"kzeni_disable_theme_plugin_update_emails_plugin_extra_links",
10,
2
);

function kzeni_disable_theme_plugin_update_emails_settings_plugin_links($actions)
{
$actions = array_merge(array('settings' => '<a href="' . admin_url('options-general.php#disable-theme-plugin-update-emails') . '">' . __('Settings', 'kzeni_disable_theme_plugin_update_emails') . '</a>'), $actions);
function kzeni_disable_theme_plugin_update_emails_settings_plugin_links(
$actions
) {
$actions = array_merge(
[
"settings" =>
'<a href="' .
admin_url("options-general.php#disable-theme-plugin-update-emails") .
'">' .
__("Settings", "kzeni_disable_theme_plugin_update_emails") .
"</a>",
],
$actions
);
return $actions;
}
add_action('plugin_action_links_' . KZENI_DISABLE_THEME_PLUGIN_UPDATE_EMAILS_NAME, 'kzeni_disable_theme_plugin_update_emails_settings_plugin_links');
add_action(
"plugin_action_links_" . KZENI_DISABLE_THEME_PLUGIN_UPDATE_EMAILS_NAME,
"kzeni_disable_theme_plugin_update_emails_settings_plugin_links"
);
11 changes: 9 additions & 2 deletions readme.txt
View file
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@ Contributors: KZeni
Donate link: https://www.paypal.me/KZeni
License: GPLv3
Tags: plugin update, theme update, notifications, email, updates, disable
Stable tag: 2.0.4
Stable tag: 2.0.5
Requires at least: 5.5
Tested up to: 6.3
Tested up to: 6.4
Requires PHP: 5.4

Disables the default notification emails sent by a site after an automatic theme and/or plugin update. Simply activate the plugin to disable these email notifications (allows failure notices through unless setting is enabled to disable these as well).
Expand Down Expand Up @@ -40,6 +40,13 @@ Try out [Disable WordPress Core Update Email](https://wordpress.org/plugins/disa

== Changelog ==

= 2.0.5 =

Released October 24th, 2023

* Added new link to the plugin details on the main plugin page.
* Confirmed WordPress 6.4 compliance.

= 2.0.4 =

Released July 24th, 2023
Expand Down

0 comments on commit c396500

Please sign in to comment.