wp/wp-content/plugins/wp-db-backup/readme.txt
author ymh <ymh.work@gmail.com>
Mon, 14 Oct 2019 17:39:30 +0200
changeset 7 cf61fcea0001
parent 0 d970ebf37754
child 18 be944660c56a
permissions -rw-r--r--
resynchronize code repo with production
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     1
=== WP-DB-Backup ===
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     2
Contributors: filosofo
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     3
Donate link: http://austinmatzko.com/wordpress-plugins/wp-db-backup/
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     4
Tags: mysql, database, backup, cron
7
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
     5
Requires at least: 3.6.0
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
     6
Tested up to: 4.9.2
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
     7
Stable tag: 2.3.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
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    13
WP-DB-Backup allows you easily to backup your core WordPress database tables.  You may also backup other tables in the same database.
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
   http://www.fsf.org/licensing/licenses/gpl.html
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    17
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    18
              NO WARRANTY.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    19
7
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    20
	Copyright (c) 2018 Austin Matzko
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    21
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    22
[Source Code on GitHub](https://github.com/matzko/wp-db-backup)
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    23
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    24
== Installation ==
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    25
1. Extract the wp-db-backup/ folder file to /wp-content/plugins/
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    26
1. Activate the plugin at your blog's Admin -> Plugins screen
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    27
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
    28
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
    29
   For example:
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    30
   `$ cd /wordpress/`
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    31
   `$ 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
    32
   `$ chmod g+w wp-content`
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    33
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    34
== Frequently Asked Questions ==
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    35
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    36
= How do I restore my database from a backup? =
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    37
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    38
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
    39
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    40
= My backup stops or hangs without completing. =
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    41
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    42
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
    43
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    44
`/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    45
* Set MOD_EVASIVE_OVERRIDE to true
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    46
* and increase MOD_EVASIVE_DELAY
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    47
* if the backup stops prematurely.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    48
*/
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    49
// define('MOD_EVASIVE_OVERRIDE', false);
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    50
define('MOD_EVASIVE_DELAY', '500');`
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    51
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    52
Do what it says: un-comment MOD_EVASIVE_OVERRIDE and set it to true like so:
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    53
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    54
`define('MOD_EVASIVE_OVERRIDE', true);`
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    55
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    56
That will slow down the plugin, and you can slow it even further by increasing the MOD_EVASIVE_DELAY number from 500.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    57
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    58
Better yet, put the lines that define the `MOD_EVASIVE_OVERRIDE` and `MOD_EVASIVE_DELAY` constants in your wp-config.php file, so your settings don't get erased when you upgrade the plugin.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    59
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    60
= What is wp-db-backup.pot for? =
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    61
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    62
This files is used by non-English users to translate the display into their native language.  Translators are encouraged to send me translated files, which will be made available to others here:
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    63
http://austinmatzko.com/wordpress-plugins/wp-db-backup/i18n/
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    64
http://plugins.trac.wordpress.org/browser/wp-db-backup/i18n/
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    65
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    66
= Why are only the core database files backed up by default? =
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    67
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    68
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.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    69
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    70
== Usage ==
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    71
1. Click the Tools or Manage menu in your WordPress admin area.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    72
1. Click the Backup sub-menu.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    73
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    74
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
    75
  ** NOTE **
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    76
  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
    77
  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
    78
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    79
1. Select how you'd like the backup to be delivered:
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    80
* 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
    81
* Email : this will email the backup file to the address you specify
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    82
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    83
1. Click "Backup!" and your database backup will be delivered to you.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    84
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    85
The filename of the backup file will be of the form
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    86
   DB_prefix_date.sql
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    87
DB = the name of your WordPress database, as defined in wp-config.php
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    88
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
    89
date = CCYYmmdd_B format:  20050711_039
7
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    90
       the "B" is the internet "Swatch" time.
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    91
       See the PHP date() function for details.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    92
7
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    93
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
    94
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    95
== Changelog ==
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    96
7
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    97
= 2.3.0 =
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    98
* Remove backup directory use
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    99
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   100
= 2.2.4 =
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   101
* Remove deprecated functionality
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   102
* Do not attempt to delete non-existent files
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   103
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   104
= 2.2.3 =
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   105
* Nonce check fix for localized WP users from Sergey Biryukov
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   106
* Fix for gzipped files' incorrect size.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   107
* Some styling improvements.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   108
* Fix for JS multiple checkbox selection.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   109
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   110
== Upgrade Notice ==
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   111
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   112
= 2.2.3 =
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   113
* Fixes problems users had when using localized WordPress installations.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   114
* 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
   115
7
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   116
= 2.3.3 =
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   117
* Sanitize user-supplied data
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   118
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   119
== Advanced ==
7
cf61fcea0001 resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
   120
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
   121
of your choice.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   122
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   123
== Translators ==
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   124
Thanks to following people for providing translation files for WP-DB-Backup:
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   125
* Abel Cheung
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   126
* Alejandro Urrutia
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   127
* Alexander Kanakaris
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   128
* Angelo Andrea Iorio
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   129
* Calle
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   130
* Daniel Erb
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   131
* Daniel Villoldo
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   132
* Diego Pierotto
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   133
* Eilif Nordseth
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   134
* Eric Lassauge
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   135
* Friedlich
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   136
* Gilles Wittezaele
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   137
* Icemanpro
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   138
* İzzet Emre Erkan
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   139
* Jong-In Kim
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   140
* Kaveh
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   141
* Kessia Pinheiro
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   142
* Kuratkoo
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   143
* Majed Alotaibi
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   144
* Michał Gołuński
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   145
* Michele Spagnuolo
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   146
* Paopao
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   147
* Philippe Galliard
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   148
* Robert Buj
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   149
* Roger
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   150
* Rune Gulbrandsøy
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   151
* Serge Rauber
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   152
* Sergey Biryukov
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   153
* Tai
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   154
* Timm Severin
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   155
* Tzafrir Rehan
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   156
* 吴曦
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   157
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   158
== Past Contributors ==
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   159
skippy, Firas, LaughingLizard, MtDewVirus, Podz, Ringmaster