wp/wp-content/plugins/wp-db-backup/readme.txt
author ymh <ymh.work@gmail.com>
Wed, 21 Sep 2022 18:19:35 +0200
changeset 18 be944660c56a
parent 7 cf61fcea0001
child 19 3d72ae0968f4
permissions -rw-r--r--
Site enmi version 09/2022
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
18
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
     1
=== Database Backup for WordPress ===
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
     2
Contributors: deliciousbrains
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     3
Tags: mysql, database, backup, cron
7
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
     4
Requires at least: 3.6.0
18
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
     5
Tested up to: 5.7
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
     6
Stable tag: 2.4
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
     7
Requires PHP: 5.3
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     8
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     9
On-demand backup of your WordPress database.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    10
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    11
== Description ==
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    12
18
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    13
Database Backup for WordPress allows you easily to backup your core WordPress database tables.  You may also backup other tables in the same database.
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    14
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    15
Released under the terms of the GNU GPL, version 2.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    16
18
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    17
[Source Code on GitHub](https://github.com/deliciousbrains/wp-db-backup)
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    18
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    19
== Installation ==
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    20
1. Extract the wp-db-backup/ folder file to /wp-content/plugins/
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    21
1. Activate the plugin at your blog's Admin -> Plugins screen
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    22
1. The plugin will attempt to create a directory /wp-content/backup-*/ inside your WordPress directory.
7
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    23
1. You may need to make /wp-content writable (at least temporarily) for it to create this directory.
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    24
   For example:
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    25
   `$ cd /wordpress/`
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    26
   `$ chgrp www-data wp-content` (where "`www-data`" is the group your FTP client uses)
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    27
   `$ chmod g+w wp-content`
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    28
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    29
== Frequently Asked Questions ==
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    30
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    31
= How do I restore my database from a backup? =
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    32
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    33
Briefly, use phpMyAdmin, which is included with most hosting control panels. More details and links to further explanations are [here](http://codex.wordpress.org/Restoring_Your_Database_From_Backup).
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    34
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    35
= My backup stops or hangs without completing. =
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    36
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    37
If you edit the text of wp-db-backup.php in a text editor like Notepad, you’ll see around line 50 the following:
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    38
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    39
`/**
18
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    40
* Set DBBWP_MOD_EVASIVE_OVERRIDE to true
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    41
* and increase DBBWP_MOD_EVASIVE_DELAY
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    42
* if the backup stops prematurely.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    43
*/
18
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    44
// define('DBBWP_MOD_EVASIVE_OVERRIDE', false);
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    45
define('DBBWP_MOD_EVASIVE_DELAY', '500');`
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    46
18
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    47
Do what it says: un-comment DBBWP_MOD_EVASIVE_OVERRIDE and set it to true like so:
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    48
18
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    49
`define('DBBWP_MOD_EVASIVE_OVERRIDE', true);`
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    50
18
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    51
That will slow down the plugin, and you can slow it even further by increasing the DBBWP_MOD_EVASIVE_DELAY number from 500.
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    52
18
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    53
Better yet, put the lines that define the `DBBWP_MOD_EVASIVE_OVERRIDE` and `DBBWP_MOD_EVASIVE_DELAY` constants in your wp-config.php file, so your settings don't get erased when you upgrade the plugin.
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    54
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    55
= What is wp-db-backup.pot for? =
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    56
18
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    57
This files is used by non-English users to translate the display into their native language.  Translators are encouraged to submit translated files, which will be made available to others here:
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    58
http://plugins.trac.wordpress.org/browser/wp-db-backup/i18n/
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    59
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    60
= Why are only the core database files backed up by default? =
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    61
18
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    62
Because it's a fairly safe bet that the core WordPress files will be successfully backed up.  Plugins vary wildly in the amount of data that they store.  For instance, it's not uncommon for some statistics plugins to have tens of megabytes worth of visitor statistics.  These are not exactly essential items to restore after a catastrophic failure. Most poeple can reasonably live without this data in their backups.
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    63
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    64
== Usage ==
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    65
1. Click the Tools or Manage menu in your WordPress admin area.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    66
1. Click the Backup sub-menu.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    67
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    68
1. The plugin will look for other tables in the same database.  You may elect to include other tables in the backup.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    69
  ** NOTE **
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    70
  Including other tables in your backup may substantially increase the size of the backup file!
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    71
  This may prevent you from emailing the backup file because it's too big.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    72
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    73
1. Select how you'd like the backup to be delivered:
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    74
* Download to your computer : this will send the backup file to your browser to be downloaded
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    75
* Email : this will email the backup file to the address you specify
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    76
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    77
1. Click "Backup!" and your database backup will be delivered to you.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    78
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    79
The filename of the backup file will be of the form
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    80
   DB_prefix_date.sql
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    81
DB = the name of your WordPress database, as defined in wp-config.php
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    82
prefix = the table prefix for this WordPress blog, as defined in wp-config.php
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    83
date = CCYYmmdd_B format:  20050711_039
7
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    84
       the "B" is the internet "Swatch" time.
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    85
       See the PHP date() function for details.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    86
7
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    87
When having the database backup emailed or sent to your browser for immediate download, the backup file will be _deleted_ from the server when the transfer is finished.
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    88
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    89
== Changelog ==
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    90
18
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    91
= 2.4 =
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    92
* Compatibility with PHP 8 and WordPress 5.7
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    93
* Fix email backup functionality
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    94
* Fix for bug where backup file would be gzipped twice
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    95
* Fixes for several PHP notices
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    96
* Add `DBBWP_` prefix to global constants
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    97
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
    98
= 2.3 =
7
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    99
* Remove backup directory use
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   100
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   101
= 2.2.4 =
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   102
* Remove deprecated functionality
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   103
* Do not attempt to delete non-existent files
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   104
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   105
= 2.2.3 =
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   106
* Nonce check fix for localized WP users from Sergey Biryukov
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   107
* Fix for gzipped files' incorrect size.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   108
* Some styling improvements.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   109
* Fix for JS multiple checkbox selection.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   110
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   111
== Upgrade Notice ==
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   112
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   113
= 2.2.3 =
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   114
* Fixes problems users had when using localized WordPress installations.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   115
* Fixes a bug that caused the size of gzipped backup files to be reported incorrectly.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   116
7
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   117
= 2.3.3 =
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   118
* Sanitize user-supplied data
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   119
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   120
== Advanced ==
7
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   121
If you are using WordPress version 2.1 or newer, you can schedule automated backups to be sent to the email address
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   122
of your choice.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   123
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   124
== Translators ==
18
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
   125
Thanks to following people for providing translation files for Database Backup for WordPress:
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   126
* Abel Cheung
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   127
* Alejandro Urrutia
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   128
* Alexander Kanakaris
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   129
* Angelo Andrea Iorio
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   130
* Calle
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   131
* Daniel Erb
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   132
* Daniel Villoldo
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   133
* Diego Pierotto
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   134
* Eilif Nordseth
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   135
* Eric Lassauge
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   136
* Friedlich
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   137
* Gilles Wittezaele
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   138
* Icemanpro
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   139
* İzzet Emre Erkan
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   140
* Jong-In Kim
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   141
* Kaveh
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   142
* Kessia Pinheiro
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   143
* Kuratkoo
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   144
* Majed Alotaibi
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   145
* Michał Gołuński
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   146
* Michele Spagnuolo
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   147
* Paopao
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   148
* Philippe Galliard
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   149
* Robert Buj
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   150
* Roger
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   151
* Rune Gulbrandsøy
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   152
* Serge Rauber
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   153
* Sergey Biryukov
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   154
* Tai
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   155
* Timm Severin
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   156
* Tzafrir Rehan
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   157
* 吴曦
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   158
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   159
== Past Contributors ==
18
be944660c56a Site enmi version 09/2022
ymh <ymh.work@gmail.com>
parents: 7
diff changeset
   160
filosofo, skippy, Firas, LaughingLizard, MtDewVirus, Podz, Ringmaster