wp/wp-content/plugins/wp-db-backup/README.markdown
changeset 0 d970ebf37754
child 7 cf61fcea0001
equal deleted inserted replaced
-1:000000000000 0:d970ebf37754
       
     1 WP-DB-Backup
       
     2 ============
       
     3 
       
     4 Contributors: filosofo
       
     5 Donate link: http://austinmatzko.com/wordpress-plugins/wp-db-backup/
       
     6 Tags: mysql, database, backup, cron
       
     7 Requires at least: 2.0.3
       
     8 Tested up to: 3.6.1
       
     9 Stable tag: 2.2.4
       
    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    http://www.fsf.org/licensing/licenses/gpl.html
       
    20 
       
    21               NO WARRANTY.
       
    22 
       
    23 	Copyright (c) 2013 Austin Matzko
       
    24 
       
    25 Installation 
       
    26 ------------
       
    27 
       
    28 1. Extract the wp-db-backup/ folder file to /wp-content/plugins/
       
    29 1. Activate the plugin at your blog's Admin -> Plugins screen
       
    30 1. The plugin will attempt to create a directory /wp-content/backup-*/ inside your WordPress directory.
       
    31 1. You may need to make /wp-content writable (at least temporarily) for it to create this directory. 
       
    32    For example:
       
    33    `$ cd /wordpress/`
       
    34    `$ chgrp www-data wp-content` (where "`www-data`" is the group your FTP client uses)
       
    35    `$ chmod g+w wp-content`
       
    36 
       
    37 Frequently Asked Questions 
       
    38 --------------------------
       
    39 
       
    40 How do I restore my database from a backup? 
       
    41 -------------------------------------------
       
    42 
       
    43 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).
       
    44 
       
    45 Why can't I schedule automatic backups to be saved to my server? 
       
    46 ----------------------------------------------------------------
       
    47 
       
    48 Although WP-DB-Backup provides the option of saving the backup file to the server, I strongly discourage anyone from leaving backed-up database files on the server. If the server is not perfectly configured, then someone could gain access to your data, and I do not want to make it easy for that to happen.
       
    49 
       
    50 My backup stops or hangs without completing. 
       
    51 --------------------------------------------
       
    52 
       
    53 If you edit the text of wp-db-backup.php in a text editor like Notepad, you’ll see around line 50 the following:
       
    54 
       
    55 `/**
       
    56 * Set MOD_EVASIVE_OVERRIDE to true
       
    57 * and increase MOD_EVASIVE_DELAY
       
    58 * if the backup stops prematurely.
       
    59 */
       
    60 // define('MOD_EVASIVE_OVERRIDE', false);
       
    61 define('MOD_EVASIVE_DELAY', '500');`
       
    62 
       
    63 Do what it says: un-comment MOD_EVASIVE_OVERRIDE and set it to true like so:
       
    64 
       
    65 `define('MOD_EVASIVE_OVERRIDE', true);`
       
    66 
       
    67 That will slow down the plugin, and you can slow it even further by increasing the MOD_EVASIVE_DELAY number from 500.
       
    68 
       
    69 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.
       
    70 
       
    71 What is wp-db-backup.pot for? 
       
    72 -----------------------------
       
    73 
       
    74 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:
       
    75 http://austinmatzko.com/wordpress-plugins/wp-db-backup/i18n/
       
    76 http://plugins.trac.wordpress.org/browser/wp-db-backup/i18n/
       
    77 
       
    78 Why are only the core database files backed up by default? 
       
    79 ----------------------------------------------------------
       
    80 
       
    81 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.
       
    82 
       
    83 Usage 
       
    84 -----
       
    85 
       
    86 1. Click the Tools or Manage menu in your WordPress admin area.
       
    87 1. Click the Backup sub-menu.
       
    88 
       
    89 1. The plugin will look for other tables in the same database.  You may elect to include other tables in the backup.
       
    90   ** NOTE **
       
    91   Including other tables in your backup may substantially increase the size of the backup file!
       
    92   This may prevent you from emailing the backup file because it's too big.
       
    93 
       
    94 1. Select how you'd like the backup to be delivered:
       
    95  * Save to server : this will create a file in /wp-content/backup-*/ for you to retreive later
       
    96  * Download to your computer : this will send the backup file to your browser to be downloaded
       
    97  * Email : this will email the backup file to the address you specify
       
    98 
       
    99 1. Click "Backup!" and your database backup will be delivered to you.
       
   100 
       
   101 The filename of the backup file will be of the form
       
   102    DB_prefix_date.sql
       
   103 DB = the name of your WordPress database, as defined in wp-config.php
       
   104 prefix = the table prefix for this WordPress blog, as defined in wp-config.php
       
   105 date = CCYYmmdd_B format:  20050711_039
       
   106        the "B" is the internet "Swatch" time.  
       
   107        See the PHP date() function for details.
       
   108 
       
   109 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.  Only if you select delivery method "Save to server" will the backup file remain on your server.
       
   110 
       
   111    *** SECURITY WARNING ***
       
   112    Your database backup contains sensitive information,
       
   113    and should not be left on the server for any extended
       
   114    period of time.  The "Save to server" delivery method is provided
       
   115    as a convenience only.  I will not accept any responsibility
       
   116    if other people obtain your backup file.
       
   117    *** SECURITY WARNING ***
       
   118 
       
   119 Changelog 
       
   120 ---------
       
   121 
       
   122 2.2.3  
       
   123 -----
       
   124 * Nonce check fix for localized WP users from Sergey Biryukov
       
   125 * Fix for gzipped files' incorrect size.
       
   126 * Some styling improvements.
       
   127 * Fix for JS multiple checkbox selection.
       
   128 
       
   129 Upgrade Notice 
       
   130 --------------
       
   131 
       
   132 2.2.3 
       
   133 -----
       
   134 * Fixes problems users had when using localized WordPress installations.
       
   135 * Fixes a bug that caused the size of gzipped backup files to be reported incorrectly.
       
   136 
       
   137 Advanced 
       
   138 --------
       
   139 If you are using WordPress version 2.1 or newer, you can schedule automated backups to be sent to the email address 
       
   140 of your choice.
       
   141 
       
   142 Translators 
       
   143 -----------
       
   144 Thanks to following people for providing translation files for WP-DB-Backup:
       
   145 
       
   146 * Abel Cheung
       
   147 * Alejandro Urrutia
       
   148 * Alexander Kanakaris
       
   149 * Angelo Andrea Iorio
       
   150 * Calle
       
   151 * Daniel Erb
       
   152 * Daniel Villoldo
       
   153 * Diego Pierotto
       
   154 * Eilif Nordseth
       
   155 * Eric Lassauge
       
   156 * Friedlich
       
   157 * Gilles Wittezaele
       
   158 * Icemanpro
       
   159 * İzzet Emre Erkan
       
   160 * Jong-In Kim
       
   161 * Kaveh
       
   162 * Kessia Pinheiro
       
   163 * Kuratkoo
       
   164 * Majed Alotaibi
       
   165 * Michał Gołuński
       
   166 * Michele Spagnuolo
       
   167 * Paopao
       
   168 * Philippe Galliard
       
   169 * Robert Buj
       
   170 * Roger
       
   171 * Rune Gulbrandsøy
       
   172 * Serge Rauber
       
   173 * Sergey Biryukov
       
   174 * Tai
       
   175 * Timm Severin
       
   176 * Tzafrir Rehan
       
   177 * 吴曦
       
   178 
       
   179 Past Contributors 
       
   180 -----------------
       
   181 skippy, Firas, LaughingLizard, MtDewVirus, Podz, Ringmaster