wp/wp-content/plugins/wp-db-backup/README.md
changeset 18 be944660c56a
child 19 3d72ae0968f4
equal deleted inserted replaced
17:34716fd837a4 18:be944660c56a
       
     1 Database Backup for WordPress
       
     2 ============
       
     3 
       
     4 Contributors: deliciousbrains
       
     5 Tags: mysql, database, backup, cron
       
     6 Requires at least: 3.6.0
       
     7 Tested up to: 5.7
       
     8 Stable tag: 2.4
       
     9 Requires PHP: 5.3
       
    10 
       
    11 On-demand backup of your WordPress database.
       
    12 
       
    13 Description
       
    14 -----------
       
    15 
       
    16 WP-DB-Backup allows you easily to backup your core WordPress database tables.  You may also backup other tables in the same database.
       
    17 
       
    18 Released under the terms of the GNU GPL, version 2.
       
    19 
       
    20 [Source Code on GitHub](https://github.com/deliciousbrains/wp-db-backup)
       
    21 
       
    22 Installation
       
    23 ------------
       
    24 
       
    25 1. Extract the wp-db-backup/ folder file to /wp-content/plugins/
       
    26 1. Activate the plugin at your blog's Admin -> Plugins screen
       
    27 1. The plugin will attempt to create a directory /wp-content/backup-*/ inside your WordPress directory.
       
    28 1. You may need to make /wp-content writable (at least temporarily) for it to create this directory. 
       
    29    For example:
       
    30    `$ cd /wordpress/`
       
    31    `$ chgrp www-data wp-content` (where "`www-data`" is the group your FTP client uses)
       
    32    `$ chmod g+w wp-content`
       
    33 
       
    34 Frequently Asked Questions 
       
    35 --------------------------
       
    36 
       
    37 How do I restore my database from a backup? 
       
    38 -------------------------------------------
       
    39 
       
    40 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).
       
    41 
       
    42 My backup stops or hangs without completing. 
       
    43 --------------------------------------------
       
    44 
       
    45 If you edit the text of wp-db-backup.php in a text editor like Notepad, you’ll see around line 50 the following:
       
    46 
       
    47 `/**
       
    48 * Set DBBWP_MOD_EVASIVE_OVERRIDE to true
       
    49 * and increase DBBWP_MOD_EVASIVE_DELAY
       
    50 * if the backup stops prematurely.
       
    51 */
       
    52 // define('DBBWP_MOD_EVASIVE_OVERRIDE', false);
       
    53 define('DBBWP_MOD_EVASIVE_DELAY', '500');`
       
    54 
       
    55 Do what it says: un-comment DBBWP_MOD_EVASIVE_OVERRIDE and set it to true like so:
       
    56 
       
    57 `define('DBBWP_MOD_EVASIVE_OVERRIDE', true);`
       
    58 
       
    59 That will slow down the plugin, and you can slow it even further by increasing the DBBWP_MOD_EVASIVE_DELAY number from 500.
       
    60 
       
    61 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.
       
    62 
       
    63 What is wp-db-backup.pot for? 
       
    64 -----------------------------
       
    65 
       
    66 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:
       
    67 http://plugins.trac.wordpress.org/browser/wp-db-backup/i18n/
       
    68 
       
    69 Why are only the core database files backed up by default? 
       
    70 ----------------------------------------------------------
       
    71 
       
    72 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.
       
    73 
       
    74 Usage 
       
    75 -----
       
    76 
       
    77 1. Click the Tools or Manage menu in your WordPress admin area.
       
    78 1. Click the Backup sub-menu.
       
    79 
       
    80 1. The plugin will look for other tables in the same database.  You may elect to include other tables in the backup.
       
    81   ** NOTE **
       
    82   Including other tables in your backup may substantially increase the size of the backup file!
       
    83   This may prevent you from emailing the backup file because it's too big.
       
    84 
       
    85 1. Select how you'd like the backup to be delivered:
       
    86  * Download to your computer : this will send the backup file to your browser to be downloaded
       
    87  * Email : this will email the backup file to the address you specify
       
    88 
       
    89 1. Click "Backup!" and your database backup will be delivered to you.
       
    90 
       
    91 The filename of the backup file will be of the form
       
    92    DB_prefix_date.sql
       
    93 DB = the name of your WordPress database, as defined in wp-config.php
       
    94 prefix = the table prefix for this WordPress blog, as defined in wp-config.php
       
    95 date = CCYYmmdd_B format:  20050711_039
       
    96        the "B" is the internet "Swatch" time.  
       
    97        See the PHP date() function for details.
       
    98 
       
    99 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.
       
   100 
       
   101 Changelog
       
   102 ---------
       
   103 
       
   104 2.4
       
   105 -----
       
   106 * Compatibility with PHP 8 and WordPress 5.7
       
   107 * Fix email backup functionality
       
   108 * Fix for bug where backup file would be gzipped twice
       
   109 * Fixes for several PHP notices
       
   110 * Add `DBBWP_` prefix to global constants
       
   111 
       
   112 2.3
       
   113 -----
       
   114 * Remove backup directory use
       
   115 
       
   116 2.2.4
       
   117 -----
       
   118 * Remove deprecated functionality
       
   119 * Do not attempt to delete non-existent files
       
   120 
       
   121 2.2.3
       
   122 -----
       
   123 * Nonce check fix for localized WP users from Sergey Biryukov
       
   124 * Fix for gzipped files' incorrect size.
       
   125 * Some styling improvements.
       
   126 * Fix for JS multiple checkbox selection.
       
   127 
       
   128 2.3.3
       
   129 -----
       
   130 * Sanitize user-supplied data
       
   131 
       
   132 Upgrade Notice
       
   133 --------------
       
   134 
       
   135 2.2.3
       
   136 -----
       
   137 * Fixes problems users had when using localized WordPress installations.
       
   138 * Fixes a bug that caused the size of gzipped backup files to be reported incorrectly.
       
   139 
       
   140 Advanced
       
   141 --------
       
   142 If you are using WordPress version 2.1 or newer, you can schedule automated backups to be sent to the email address 
       
   143 of your choice.
       
   144 
       
   145 Translators
       
   146 -----------
       
   147 Thanks to following people for providing translation files for WP-DB-Backup:
       
   148 
       
   149 * Abel Cheung
       
   150 * Alejandro Urrutia
       
   151 * Alexander Kanakaris
       
   152 * Angelo Andrea Iorio
       
   153 * Calle
       
   154 * Daniel Erb
       
   155 * Daniel Villoldo
       
   156 * Diego Pierotto
       
   157 * Eilif Nordseth
       
   158 * Eric Lassauge
       
   159 * Friedlich
       
   160 * Gilles Wittezaele
       
   161 * Icemanpro
       
   162 * İzzet Emre Erkan
       
   163 * Jong-In Kim
       
   164 * Kaveh
       
   165 * Kessia Pinheiro
       
   166 * Kuratkoo
       
   167 * Majed Alotaibi
       
   168 * Michał Gołuński
       
   169 * Michele Spagnuolo
       
   170 * Paopao
       
   171 * Philippe Galliard
       
   172 * Robert Buj
       
   173 * Roger
       
   174 * Rune Gulbrandsøy
       
   175 * Serge Rauber
       
   176 * Sergey Biryukov
       
   177 * Tai
       
   178 * Timm Severin
       
   179 * Tzafrir Rehan
       
   180 * 吴曦
       
   181 
       
   182 Past Contributors
       
   183 -----------------
       
   184 filosofo, skippy, Firas, LaughingLizard, MtDewVirus, Podz, Ringmaster