-
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
429 lines (330 loc) · 15.4 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
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
=== Go Live Update Urls ===
Contributors: Mat Lipe, onpointplugins
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=paypal%40onpointplugins%2ecom&lc=US&item_name=Go%20Live%20Update%20Urls&no_note=0¤cy_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest
Tags: search and replace, database, urls, domain, update urls
Requires at least: 6.2.0
Tested up to: 6.7.1
Requires PHP: 7.4.0
Stable tag: 7.0.2
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html
Change the domain on your site with one click.
== Description ==
### Change the domain on your site with one click.
Goes through entire site and replaces all instances of an old URL with a new one. Used most often when changing the domain of your site.
### Goals
* Take the guesswork out of changing a domain.
* Provide a super simple process for updating URLs.
* Accurately update all instances of a URL on any site.
### Features
* Database table by table selection.
* Updates serialized data.
* Updates encoded URL.
* Easy to use admin page - which may be found under Tools.
* Works on both multisite and single site installs.
### Updates Entire Site Including
* Posts
* Pages
* Image URLs
* Excerpts
* Post meta data
* Custom post types
* Widgets and widget data
* Options and settings
* And much more
### Additional Uses
The plugin may also be used to update anything within the database. Including but not limited to:
* Domains
* Email addresses
* Gutenberg blocks
* Links
* Shortcodes
* Text
* Usernames
* Widgets
* Really anything which can be entered in a text field.
### What Makes Go Live Update Urls Special?
#### Domain Considerations
Updating a domain or URL in a database is not always as simple as just matching one text and changing it to another. Domains may include things like subdomains or email addresses which end up duplicated or broken when doing a simple replace.
The Go Live Update Urls plugin automatically detects and handles special domain circumstances to give you an accurate update every time without side effects.
#### WordPress Data Types
WordPress stores various data types in the database, some of which do not support straightforward replacement methods. An example of this is serialized data.
The Go Live Update URLs plugin has built-in support for WordPress data types, which automatically:
1. Parses the data into a replaceable format.
2. Updates the data.
3. Restores the data to its original format and saves the updated version.
#### Gracefully Handle Serialized Data
WordPress stores arrays and objects in the database as serialized data. Serialized data cannot be updated using a simple search and replace method because serialized data contains a length value which would be incorrect after a simple replace.
Go Live Update Urls gracefully and accurately replaces serialized data in any WordPress Core database table. The [PRO version](https://onpointplugins.com/product/go-live-update-urls-pro/) replaces serialized data in any table.
Another consideration with serialized data is invalid data left behind from plugins which are no longer in use. Go Live Update Urls is the only tool capable of detecting and managing updates to invalid serialized data without failing or breaking the site.
#### Performance
A feature unique to Go Live Update URLs is that the plugin identifies database rows and columns containing complex data types and updates only the necessary items. This targeted approach significantly improves performance and minimizes the load on the database server during updates.
#### Cache Clearing
Go Live Update Urls automatically clears the WordPress cache as well as many common 3rd party plugin caches when the updates are completed. This ensures that the site is ready to go live immediately after the update.
<h3>Domain Update Process</h3>
Full step-by-step instructions for a changing a site's domain <a target="_blank" href="https://onpointplugins.com/how-to-change-your-domain-name-on-wordpress/">may be found here</a>.
<h3>Included Language Translations</h3>
* English (en_US).
* French (fr_FR).
* German (de_DE).
* Spanish (es_ES).
<h3>Developers</h3>
Developer docs <a target="_blank" href="https://onpointplugins.com/go-live-update-urls/developer-docs-go-live-update-urls/">may be found here</a>.
<h3>Troubleshooting</h3>
Troubleshooting information <a target="_blank" href="https://onpointplugins.com/go-live-update-urls/go-live-update-urls-troubleshooting/">may be found here</a>.
<h3>Contribute</h3>
Send pull requests via the <a href="https://github.com/lipemat/go-live-update-urls/">Github Repo</a>
<h3>Go PRO</h3>
Our [PRO version](https://onpointplugins.com/product/go-live-update-urls-pro/?utm_source=readme&utm_campaign=gopro&utm_medium=dot-org) brings additional functionality to this plugin. Check out [the demo](https://onpointplugins.com/go-live-update-urls/go-live-update-urls-pro-demo/?utm_source=demo&utm_campaign=gopro&utm_medium=dot-org) to see if the PRO version is useful for you.
* Updates database tables created by plugins.
* Database tables are organized into simple intuitive sections.
* Ability to choose between tables or sections.
* Ability to convert relative URL into absolute URL.
* Updates serialized data across any table.
* Updates encoded URL across any table.
* Updates JSON data across any table.
* Ability to test URL changes before running them.
* URL testing report is provided for peace of mind.
* Option to fix common mistakes automatically when entering a URL.
* View and use history of your site's address.
* Accessible update history including count and location of updated URL. **New**
* Predictive URL automatically fill in the "Old URL" and "New URL."
* Real time reporting of count and location of URL which will be updated.
* Report of count and location of URL which were updated.
* WP-CLI support for updating URL from the command line.
* Priority support with access to members only support area.
== Installation ==
Use the standard WordPress plugins search and installer.
Activate the plugin.
Use the "Go Live" page, located under the Tools menu, in the WordPress admin.
Manual Installation
1. Upload the `go-live-upload-urls` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
== Frequently Asked Questions ==
= Where do you use this plugin? =
Under the Tools menu in the dashboard there will be a "Go Live" link.
= Why does updating the domain break some plugins? =
Some plugins will store the serialized or JSON data in the database which does not allow for easy updating of the data. You may un-check tables used by such plugins and then update the urls manually for those plugins. Currently, the options, postmeta, usermeta, commentmeta, blogmeta, and sitemeta tables are serialization safe. The <a href="https://onpointplugins.com/product/go-live-update-urls-pro/" target="_blank">PRO Version</a> supports updating all tables created by plugins, including ones with serialized or JSON data.
= How do I know which tables I should not update? =
Most tables will be just fine to update. This plugin will tell you which tables not to update.
If you wish to try to update tables mentioned as "not safe" anyway, you may:
1. Make a backup of your database.
2. Run the update with all tables checked.
If you run into trouble:
1. Restore your database.
2. Un-check tables in sections.
3. Re-run this until you find the culprit.
If you find you are running into issues with custom tables, you may want to check out the <a href="https://onpointplugins.com/product/go-live-update-urls-pro/" target="_blank">PRO Version</a> of this plugin, which works with any table.
== Screenshots ==
1. Tools page. The list of tables will change depending on your database structure.
2. Successfully updated urls.
3. Update prevented due to incomplete data entered.
== Changelog ==
= 7.0.2 =
* Adjusted memory limit during counting to assure all tables are counted.
= 7.0.1 =
* Improved readme.
* Tested to WordPress 6.7.1.
= 7.0.0 =
* Introduced class constants for admin capability and parent menu.
* Introduced `Admin::get_admin_capability` method.
* Introduced `go-live-update-urls/admin/admin-capability` filter.
* Removed deprecated `Core::sanitize_field` method.
* Converted GitHub Actions and Git hooks to distributed versions.
* Tested to WordPress 6.6.2.
* Required PRO version 7.0.0+.
= 6.8.0 =
* Added support for PHP based translations.
* Bumped required WordPress version to 6.2.0.
* Dropped support for PHP 7.2 in favor of 7.4+.
* Tested to WordPress 6.6.0.
* Officially added support for PHP 8.3.
* Required PRO version 6.13.0+.
= 6.7.3 =
* Improved the readme.
* Added a plugin domain to the translation files headers.
* Bumped required WordPress version to 6.1.0.
* Added live preview supporting using a playground blueprint.
* Update PHPUnit support to version 10.
* Tested to WordPress version 6.5.0.
*
= 6.7.2 =
* Fixed deprecated notices in PHP 8.2.
* Introduced `go_live_update_urls_sanitize_field` function.
* Misc code improvements.
* Tested to WordPress version 6.4.2.
= 6.7.1 =
* Made admin styles more resilient to style conflicts.
* Added support for sites which don't include the `wp_links` table.
* Introduced a shared `render_admin_header` method for the tools page header.
= 6.7.0 =
* Dropped support for PHP 7.0 in favor of 7.2.
* Bumped minimum supported WordPress version to 6.0.0.
* Improved block preview link handling.
* Required PRO version 6.10.3+.
= 6.6.3 =
* Updated node version to 18.
* Improved static analysis tools and scan level.
* Improved support for PHP 8.2.
* Tested to WordPress version 6.4.1.
= 6.6.2 =
* Updated Stylelint configuration and modernized CSS.
* Included admin notices on network admin page.
* Updated WP-PHPCS to version 3 and fixed all findings.
= 6.6.1 =
* Updated documentation links.
* Tested to WordPress version 6.3.1.
= 6.6.0 =
* Added support for updating keys in serialized data.
* Added support for updating sub serialized data values.
* Enhanced all data updaters.
* Included table and row_id information to error log when a row is skipped.
* Improved miscellaneous PHP docs and type hints.
* Fixed issue with updaters breaking paths when adding a sub-path to a URL.
* Tested to WordPress core 6.3.
* Updated the minimum WordPress core requirement to version 5.8.
* Updated the PRO version requirement to version 6.10.0.
= 6.5.3 =
* Improved plugin readme.
* Tested to WordPress version 6.2.2.
= 6.5.2 =
* Modernized the tools page JavaScript.
* Improved extendability by removing all `private` access modifiers.
* Improved extendability by converting all `self` to `static`.
* Improved PHPCS scanning.
* Fully support PHP 8.1.
* Tested to WordPress Core 6.2.0.
= 6.5.1 =
* Fixed handling of row skipping for PHP 7.0.
= 6.5.0 =
* Gracefully handle missing PHP classes in serialized data.
* Introduced `Skip_Rows` class for programmatically skipping database row updates.
* Introduced `go-live-update-urls-pro/database/supports-skipping` filter to disable row skipping.
* Tested to WordPress Core version 6.1.1.
= 6.4.1 =
* Improved readme.
* Added GPL license to plugin.
* Tested to WordPress core version 6.1.0.
= 6.4.0 =
* Dropped support for PHP 5.6 in favor of PHP 7.0.
* Required PRO version 6.8.0+.
= 6.3.9 =
* Tested to WordPress 6.0.1.
* Mentioned updating encoded URL in readme.
= 6.3.8 =
* Improved translations.
* Fix typo in the readme.
* Required PRO version 6.6.0+.
* Tested to WordPress 6.0.0.
= 6.3.7 =
* Added "Settings" link to plugin actions.
* Introduced `Admin::get_url` method for retrieving URL or tools page.
* Fixed title of tools page in browser tab.
= 6.3.6 =
* Improved internal URL utm structure.
* Tested to WordPress 5.9.0.
= 6.3.5 =
* Tested to WordPress 5.8.3.
* Fix issue with tables showing from other sites on multisite.
= 6.3.4 =
* Support updating URL with URL encoded characters.
* Tested to WordPress 5.8.2.
= 6.3.3 =
* Improved capitalization across plugin verbiage.
* Improved translations.
* Tested to WordPress 5.8.1.
= 6.3.2 =
* Improved sanitization of table names.
* Fully support PHP 8.
* Tested to WordPress 5.7.2.
= 6.3.1 =
* Tested to WordPress 5.6.1.
* Improved translation process and documentation.
* Improved responsiveness of admin page.
= 6.3.0 =
* Improved readme.
* Improved plugin headers.
* Required WordPress version 5.2.0+.
= 6.2.2 =
* Pass option value when flushing Elementor cache to prevent edge case conflicts.
* Improved counting of urls across subdomains.
* Improved counting of urls across serialized data.
* Support replacing non subdomain values which duplicate because the old URL exists within the new URL.
* Introduced `go-live-update-urls/database/after-counting` action.
* Introduced `go-live-update-urls/database/before-counting` action
= 6.2.1 =
* Automatically flush Elementor's CSS cache during updates.
* Update screenshots and captions.
* Introduced new `go-live-update-urls-pro/admin/use-default-inputs` filter.
* Add CSS classes to form elements on tools page.
* Fix spacing of banners on tools page.
* Improved PHPCS implementation.
= 6.2.0 =
* Redesign tools page for a modern block look.
* Improved various verbiage.
* Update all translations.
* More gracefully handle version conflicts with PRO.
* Support for PRO version 6.2.0.
= 6.1.4 =
* Support updating `registration_log` and `signups` tables.
* Make `get_doubled_up_subdomain` method public.
= 6.1.3 =
* Support WordPress version 5.5.1
= 6.1.2 =
* Improved admin form and selectors.
* Fix filter name for `go-live-update-urls/database/column-types`.
* Improved FAQs.
* Support for PRO version 6.1.0.
= 6.1.0 =
* Automatically exclude non text database columns.
* Support email addresses within serialized data.
* Greatly improved database update performance.
* Split database update steps into their own class.
* Support URL counting for upcoming <a href="https://onpointplugins.com/product/go-live-update-urls-pro/" target="_blank">PRO</a> enhancements.
* Tested to WordPress version 5.5.0
= 6.0.1 =
* Improved compatibility with very old versions of PRO.
* Improved the readme.
* Add links for the documentation and troubleshooting.
= 6.0.0 =
* Entirely new code structure.
* Removed all deprecated code and filters.
* Improved filter and action names.
* Improved performance.
= 5.3.0 =
* Display error message when no tables are selected during update.
* Fix bug when updating columns which are name the same as MySQL commands.
* Remove confusing '- Serialized' label from checkboxes list.
* Improved stability to modernize code some code.
* Introduced `go-live-update-urls/views/admin-tools-page/disable-description` filter.
* Cleanup some long deprecated code.
= 5.2.12 =
* Support for WordPress version 5.3.0
* Officially drop support for PHP 5.4 in favor of 5.6.0
= 5.2.0 =
* Support URL Encoded Urls within serialized data
* Support JSON Encoded Urls within serialized data
= 5.1.0 =
* Added new languages including French, German, and Spanish
* Support upcoming blogmeta table in WP 5.0.0+
* Support updating urlencoded urls
* Improved support for Visual Composer
* Add PHP composer support
= 5.0.0 =
* Bring back PHP 5.2 support
* Restructure entire codebase
* Greatly improved security
* Improved performance
* UI improvements
* Use strict WP coding standards
== Upgrade Notice ==
= 6.1.2 =
Update to support PRO version 6.1.0.
= 6.0.1 =
Major version update. Not backward compatible with version 5 filters or code. Please remove any custom filters or extensions before updating.
= 5.0.6 =
Fixes bug with the submit button in some browsers
= 5.0.4 =
Fixes bug with the database not updating properly
= 5.0.1 =
For full functionality of PRO version 2.2.0