-
-
Notifications
You must be signed in to change notification settings - Fork 13
/
readme.txt
210 lines (147 loc) · 6.71 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
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
=== Say what? ===
Contributors: leewillis77
Donate link: http://plugins.leewillis.co.uk/downloads/say-what-pro?utm_source=wordpress&utm_medium=www&utm_campaign=say-what
Tags: string, change, translation
Requires at least: 6.2
Tested up to: 6.6
Requires PHP: 7.4
Stable tag: 2.2.5
License: GPLv2
An easy-to-use plugin that allows you to change translatable strings from plugins / themes and WordPress core without editing code.
== Description ==
An easy-to-use plugin that allows you to change translatable strings from plugins / themes and WordPress core without editing code. Simply enter the current string, and what you want to replace it with and the plugin will automatically do the rest!
The plugin's available for forking and contribution over on [GitHub](https://github.com/leewillis77/say-what)
Check out [Say What Pro](https://plugins.leewillis.co.uk/downloads/say-what-pro/) for:
* **String Discovery and autocomplete** - find the strings you need without diving through code. Works with server-side and Javascript-rendered strings
* **Improved performance** using text-domain-specific filters
* **Wildcard string replacements** - replace individual words, or fragments across your whole site
* **Multi-lingual support** - set different replacements for different languages on multi-lingual sites
* **Import/export features** - Easy import/export of replacements through the user interface
## Support this free plugin
As a business, we already donate a percentage of our profits from premium plugins to global climate change projects. You're free to use this plugin free of charge, but if you do, please consider [buying the world some trees](https://ecologi.com/ademtisoftware?gift-trees&r=ademtisoftware) in return. You'll be creating employment for local families and restoring wildlife habitats.
== Installation ==
* Install it as you would any other plugin
* Activate it
* Head over to Tools » Text changes and configure some string replacements
== Frequently Asked Questions ==
= Can I use it to change any string? =
You can only use the plugin to translate strings which are marked for translation.
= How do I find the string to translate? =
You can either have a guess, or checkout the plugin in question's source code, translatable strings are generally wrapped in __(), _e(), _n(), or _x(), for example:
`$foo = __('This is a translatable string', 'plugin-domain');`
The article [here](https://plugins.leewillis.co.uk/doc_post/replacing-wordpress-strings-context/) shows some examples of what you're looking for. Alternatively, the [Pro version of the plugin](https://plugins.leewillis.co.uk/downloads/say-what-pro/) provides a String Discovery mode which means you can search for strings on your site via autocomplete suggestions.
= Is there any support for importing replacements? =
"Say What?" has preliminary support for exporting, and importing replacements via [http://wp-cli.org/](WP-CLI). The following commands are currently
supported:
* export - Export all current string replacements.
* import - Import string replacements from a CSV file.
* list - Export all current string replacements. Synonym for 'export'.
* update - update string replacements from a CSV file.
See the [GitHub homepage](https://github.com/leewillis77/say-what) for examples.
= Can I set different replacements for different languages? =
Not in the free plugin, however this is available in the [Pro version of the plugin](https://plugins.leewillis.co.uk/downloads/say-what-pro/)
== Screenshots ==
1. List of configured string replacements
2. Adding/editing a replacement
== Changelog ==
= 2.2.5 =
* General tidy-ups and maintenance
= 2.2.4 =
* Fix: Do not generate warning on initial install
= 2.2.3 =
* Change: Internal package updates
* Change: Compatibility with WordPress 6.6
= 2.2.2 =
* Fix: Resolve issue where replacements weren't made if an external object cache was in use.
= 2.2.1 =
* Change: Internal refactor of classes
= 2.1.9 =
* Change: Minor admin UI changes
= 2.1.8 =
* Fix: Include missing image
= 2.1.7 =
* Change: Admin UI updates
= 2.1.6 =
* Change: Styling & documentation updates.
= 2.1.5 =
* Fix: Avoid warning when sorting list table.
= 2.1.4 =
* Change: Localisation improvements
= 2.1.3 =
* Change: Updates to Javascript dependencies.
= 2.1.2 =
* Change: Updates to Javascript dependencies, smaller JS footprint.
= 2.1.1 =
* Fix: Resolve issue where console errors could be thrown if no replacements configured.
= 2.1.0 =
* New: Optimise performance when an external object cache is available
* Fix: Imports via WP-CLI could fail if the pro extension had previously been active
= 2.0.2 =
* Reduce size of bundled images
* Update dev build scripts
= 2.0.1 =
* Improve Javascript performance, and remove lodash dependency (resolves some plugin conflicts)
= 2.0.0 =
* Support for translatable strings rendered through WordPress Javascript framework
* Supports replacing text in Gutenberg / WooCommerce admin / WooCommerce blocks
* Update details of Say What? Pro vs free plugin
= 1.9.7 =
* Fix issue where replacement table disappeared at small screen widths
* Update WordPress compatibility
* Changes to donation / upsell content
= 1.9.6 =
* Fix link in documentation
= 1.9.5 =
* WordPress 5.5 compatibility
* Changes to Treeware links
= 1.9.4 =
* Ensure help links open in new windows
= 1.9.3 =
* Fix link target in Treeware content
= 1.9.2 =
* Suggest Treeware donations
= 1.9.1 =
* Update information about Pro features
= 1.9.0 =
* Fix issue adding more strings after downgrade from Pro
* Update text domain of plugin to match wordpress.org guidelines to aid translations
= 1.8.2 =
* Documentation updates only
= 1.8.1 =
* Update plugin links, include settings and upgrade link
* Update documentation about pro features
* Admin styling fixes
= 1.8.0 =
* Fix issues where entities could be double encoded on admin screens.
= 1.7.1 =
* Update to admin marketing message. No functional changes.
= 1.7 =
* Support for _n() and _nx()
* Support for multi-line strings
= 1.6 =
Introduce filters that allows back compatibility for plugins that change their text-domain. Props Pippin Williamson
= 1.5 =
Avoid warnings on initial activation.
Avoid issues where strings contain HTML / entities
= 1.4 =
Add info box about Pro version
= 1.3 =
Support for WP-CLI import and export.
= 1.2 =
Swap database to UTF-8 to fix problems entering non-ASCII strings.
= 1.1 =
Fix incorrect escaping on the admin screens.
= 1.0.1 =
Fix initial DB table creation
Fix translations for strings with no domain
= 1.0 =
Allow strings with context to be replaced
= 0.9.3 =
Documentation improvements
= 0.9.2 =
Avoid wpdb->prepare warning
Minor admin fixes, don't double translate strings
= 0.9.1 =
Fix issue with fields being swapped when first entered
= 0.9 =
Beta ready for testing and feedback