-
Notifications
You must be signed in to change notification settings - Fork 1
/
readme.txt
142 lines (107 loc) · 5.83 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
=== Emoji Settings ===
Contributors: Cybr
Donate link: https://github.com/sponsors/sybrew
Tags: emoji, emojis, emoticon, script, twemoji
Requires at least: 5.5
Tested up to: 6.6
Stable tag: 3.0.0
Requires PHP: 7.4.0
License: GPLv3
License URI: http://www.gnu.org/licenses/gpl-3.0.html
Emoji Settings adds an option to your Writing Settings page to toggle emoji conversion to images.
== Description ==
**Quickly enable or disable emojis conversion with an option.**
When you disable the option, Emoji Settings stops the conversion of ASCII smilies like `:)` and `:D` to images on any WordPress installation. This plugin also prevents changing real emojis to Twemoji (Twitter) images. It achieves this by removing several default WordPress scripts.
You can find the option at "Settings > Writing" (`/wp-admin/options-writing.php`).
This plugin does not prevent real emojis (inserted via an emoji keyboard) from being stored and outputted on your website.
= Emoji conversion enabled by default =
I wrote this plugin with a WordPress.com-like environment in mind, giving users an option without overriding standard WordPress behavior.
You can change this behavior via filter `cw_emoji_overrides`. Refer to the code for instructions.
= Does more than "Disable Emojis" =
Emoji Settings also fixes Character Encoding issues on sites originally installed with WP 4.2 or lower. And this plugin correctly removes the conversion of emojis in the admin area, for example, from post titles.
= Translating =
You can contribute by translating Emoji Settings via the sidebar on this page.
== Installation ==
1. Install Emoji Settings either via the WordPress.org plugin directory or by uploading the files to your server.
1. Either Network Activate this plugin or activate it on a single site.
1. You can now disable emojis through the admin menu under `wp-admin/options-writing.php`.
1. That's it! Enjoy!
== Frequently Asked Questions ==
= How do I disable emojis by default =
You can implement this filter to achieve that:
`add_filter(
'cw_emoji_overrides',
function ( $overrides ) {
$overrides['default'] = '0'; // Set disabled by default.
return $overrides;
},
);`
== Changelog ==
= 3.0.0 =
* Rewritten the plugin again. It is now procedural instead of needlessly object-based, improving performance significantly.
* Now requires PHP 7.4 or later.
* Now stores the default setting in the database. This prevents extraneous database queries for unconfigured websites.
* When emojis conversion is disabled, the string `'0'` will now be stored in the database, instead of an empty string `''`. This will only take effect when the writing settings are resaved.
* The plugin's translation object is now only loaded in the admin area, reducing load for the front-end.
* Removed filter `cw_emoji_settings_load`. Use `remove_action()` instead.
* Removed function `CyberWire\Emoji_Settings\init()`.
* Removed class `CyberWire\Emoji_Settings\Emoji_Settings`.
= 2.0.0 =
* Rewritten for improved performance.
* Now requires PHP 7.2 or later.
* Now requires WP 5.5 or later because it adds tests against PHP support.
* All function and class names have changed due to added namespacing, hence the major version bump.
* Added filter `cw_emoji_overrides`, accepts array `[ 'default' => string 1|0, 'force_support' => ?bool ]`.
* Removed confusing filter `the_emoji_options`.
* Changed the option label from "Enable emoji support" to "Enable emoji conversion": this plugin prevents the conversion; it does not prevent actual emojis from being stored and printed.
= 1.2.0 =
* Now properly removes the detection script and styles from all admin screens.
* Now requires PHP 5.6 or later.
* Tested up to WP 6.0.
= 1.1.1 =
* Tested up to WP 4.9.
= 1.0.10 =
* Fixed: When `the_emoji_options` filter was incorrectly used, a PHP notice would be cast on every page load.
* Fixed: Updated license links in readme and included license file.
* Fixed: Readme typos.
= 1.0.9 =
* Improved: Overall sanitation (WordPress.com VIP standards).
* Changed: The class loader function caches the filter within as well.
* Updated: POT file.
* Removed: Dutch translation files; these are now provided through WordPress.org.
* Other: Cleaned up code.
* Note: Plugin license is upgraded from GPLv2+ to GPLv3.
= 1.0.8 =
* Improved: (performance) Saving Writing Settings no longer casts the Emoji Setting to an 1 or 0 string when it's already an 1 or 0 string.
* Improved: (performance) Removed boolean type casting on a boolean if statement.
* Other: This plugin's description on the activation page is much shorter.
= 1.0.7 =
* Note: With more than 1000 hours of extra PHP programming experience, I've updated this plugin to the latest WordPress and PHP coding standards.
* Added: WordPress.org translation compatibility.
* Added: Local PHP option caching.
* Added: Class caching.
* Added: New filter. See "Other Notes" on this plugin's homepage.
* Added: POT translation file.
* Changed: Plugin translation domain.
* Updated: Translation files.
* Improved: The defaults filter is now always cast to an array.
* Improved: Reduced plugin memory footprint.
* Cleaned up code.
= 1.0.6 =
* Fixed: PHP Warning when saving options on old WP installations.
* Changed: Improved plugin efficiency.
* Tested up to WP 4.4.0
= 1.0.5 =
* Fixed: New WordPress installations (4.3 and up) don't have the option to turn off smileys. Those before now have incorrect character encoding of smiley abbreviations, like :) and :D, when emojis are disabled. So, when you disable emojis, smilies will also be disabled.
* Improved: When disabling emojis, the smilies setting will also be disabled to reflect the workings of this plugin visually.
= 1.0.4 =
* This plugin now supports PHP 5.2 and up.
= 1.0.3 =
* Now correctly removes scripts from admin pages.
= 1.0.2 =
* Fixed option call priority.
= 1.0.1 =
* Fixed HTML on the options page.
* Added filter `the_emoji_options`.
= 1.0.0 =
* Initial Release