Met wp cloneworx-backup settings lees en wijzig je de instellingen die voor de hele website gelden. Met wp cloneworx-backup scope zie je wat bij jouw website hoort, en bepaal je wat nooit in een back-up komt.
Ontbreekt WP-CLI nog? De handleiding staat in WP-CLI installeren. Alle commando’s van de plugin staan in De opdrachten in één oogopslag.
Instellingen van een back-upplan of van een doel staan niet hier: die wijzig je met wp cloneworx-backup plan en wp cloneworx-backup target. De uitvoer van de commando’s is Engels.
De instellingen tonen: settings list
settings list toont alle instellingen met hun waarde. Zonder actie doet wp cloneworx-backup settings hetzelfde. De actie heeft geen parameters.
# Alle instellingen tonen wp cloneworx-backup settings list
Elke regel toont een sleutel en zijn waarde. (default) na de waarde betekent: de waarde is de standaard en is nooit opgeslagen. Schakelaars verschijnen als on of off. Is er geen e-mailadres ingevuld, dan toont de laatste regel het adminadres van de website: daar gaan de meldingen naartoe.
Een instelling lezen en zetten: settings get, set
settings get toont de waarde van een sleutel. settings set slaat een nieuwe waarde op. Sleutel en waarde staan zonder parameter na de actie.
| Sleutel | In de interface | Toegestane waarden | Standaard |
|---|---|---|---|
notify_emails |
E-mailadressen | tot 5 adressen als één waarde, gescheiden door komma’s | leeg: de meldingen gaan naar het adminadres van de website. |
notify_errors |
Bij fouten en waarschuwingen |
on, off
|
on |
notify_success |
Bij succes |
on, off
|
off |
notify_overdue |
Als de laatste correcte back-up ouder is dan het plan toestaat |
on, off
|
on |
step_max_seconds |
Maximale duur per stap | 5 tot 20 (seconden) | 20 |
step_pause_seconds |
Pauze tussen stappen | 0 tot 60 (seconden) | 0 |
log_keep_days |
Logboeken bewaren gedurende | 7 tot 365 (dagen) | 30 |
manual_retention |
Max. back-ups zonder plan | 1 tot 99 | 7 |
remove_all_on_delete |
Bij het verwijderen van de plugin alle instellingen en de index verwijderen. Back-ups blijven bewaard. |
on, off
|
off |
# Een instelling lezen wp cloneworx-backup settings get step_max_seconds # De maximale duur per stap op 10 seconden zetten wp cloneworx-backup settings set step_max_seconds 10 # Twee ontvangers voor meldingen invoeren wp cloneworx-backup settings set notify_emails "eins@example.com, zwei@example.com" # De e-mail na elke geslaagde back-up inschakelen wp cloneworx-backup settings set notify_success on
Na het opslaan bevestigt het commando sleutel en waarde. Accepteert de plugin een waarde niet, dan slaat hij niets op. Het commando eindigt dan met een fout en vermeldt de reden tussen haakjes:
| Reden | Betekenis |
|---|---|
unknown |
De sleutel bestaat niet. |
type |
De waarde heeft het verkeerde type, bijvoorbeeld tekst in plaats van een getal. |
range |
Het getal ligt buiten de grenzen. Het commando toont de toegestane grenzen. |
email |
Een adres is geen geldig e-mailadres. |
too_many |
Het zijn meer dan 5 adressen. |
Wat elke instelling doet, wordt uitgelegd in De pagina “Instellingen”.
remove_all_on_delete werkt pas als je de plugin in WordPress verwijdert. Met on vraagt de plugin daarbij eerst Dropbox om de toegang van elk doel van het type Dropbox in te trekken, en verwijdert daarna instellingen, doelen, de lijst met back-ups en de logboeken. Met off blijft alles in de database, en de plugin trekt niets in. De back-ups blijven in beide gevallen bewaard. Meer daarover: De plugin verwijderen.
Niet onder deze sleutels
De foutopsporing in het logboek schakel je met wp cloneworx-backup debug, en de sleutel van de inloggegevens toon en vernieuw je met wp cloneworx-backup key. Beide commando’s worden beschreven in Status, logboeken en support met WP-CLI. Uitsluitingen en tabellen stel je in met wp cloneworx-backup scope, zie hieronder.
Alle instellingen terugzetten: settings reset
settings reset zet alle sleutels uit de tabel hierboven terug op hun standaardwaarden. De uitsluitingen en de lijst met tabellen blijven daarbij zoals ze zijn.
# Alle instellingen op de standaardwaarden zetten wp cloneworx-backup settings reset
Het commando vraagt niet om bevestiging
settings reset zet meteen terug, zonder bevestigingsvraag. Ingevulde e-mailadressen zijn daarna verwijderd. Noteer vooraf de uitvoer van settings list als je de waarden nog nodig hebt.
De omvang tonen: scope
De omvang bepaalt wat bij jouw website hoort: welke mappen, welke tabellen van de database en wat wordt weggelaten. scope toont die. Het deel na scope bepaalt wat je ziet:
| Deel | Wat de uitvoer toont |
|---|---|
roots |
De roots met hun locatie op de server. Bij de database staat database. not found betekent: de plugin heeft de locatie niet gevonden. Tussen haakjes staan aanwijzingen, bijvoorbeeld inside voor een root die in een andere ligt, of missing voor een map die niet bestaat. |
tables |
Het voorvoegsel en het aantal tabellen, dan elke tabel. view markeert een view, structure only een tabel waarvan alleen de structuur wordt bewaard. Een waarschuwing vermeldt tabellen van een andere WordPress-installatie in dezelfde database: deze tabellen worden niet geback-upt. |
exclusions |
De geldende uitsluitingsregels. default in de kop betekent: de standaard geldt. stored betekent: je eigen regels gelden. Daaronder staan de mappen die andere plugins voor hun cache of hun logboeken vastleggen, en wat altijd is uitgesloten. |
all |
Alle drie de delen. Dat is de standaard als je niets opgeeft. |
# Alles tonen wp cloneworx-backup scope # Alleen de roots tonen wp cloneworx-backup scope roots # Alleen de tabellen tonen wp cloneworx-backup scope tables
De roots
Een root is een benoemd deel van de website. De namen heb je nodig voor --roots bij back-up, back-upplan en herstel.
| Root | Inhoud |
|---|---|
db |
De tabellen van de database van deze website. |
wp-config |
Het bestand wp-config.php. Het maakt nooit deel uit van een back-up. |
wp-content |
Alles in wp-content dat niet bij plugins, thema’s, must-use-plugins of uploads hoort: taalbestanden, drop-ins, mappen van andere plugins. |
wp-core |
De WordPress-kern: de mappen wp-admin en wp-includes en de bestanden die WordPress in de hoofdmap levert. |
wp-mu-plugins |
De map van de must-use-plugins. |
wp-plugins |
De map van de plugins. |
wp-themes |
De map van de thema’s. |
wp-uploads |
De map van de uploads. |
wp-root |
Al het overige in de map van de WordPress-kern, bijvoorbeeld .htaccess en robots.txt. |
wp-web |
De bestanden van de webroot als WordPress in een eigen submap met een eigen adres staat. Hoort bij wp-root; een eigen keuze is er niet. |
Uitsluitingsregels zetten: scope exclusions
Uitsluitingsregels gelden voor de hele website en voor elk back-upplan. Wat onder een regel valt, komt in geen enkele back-up.
| Parameter | Betekenis | Toegestane waarden |
|---|---|---|
--set |
Vervangt de hele lijst met regels door de opgegeven regels. | Regels, gescheiden door komma’s |
--reset |
Herstelt de standaard. | zonder waarde |
--force |
Past de wijziging ook toe als een andere gebruiker dan de gebruiker aan wie de mappen van de plugin toebehoren. | zonder waarde |
--set en --reset werken alleen samen met het deel exclusions. Een regel heeft een van vier vormen, zoals in .gitignore:
| Vorm | Betekenis | Voorbeeld |
|---|---|---|
| Naam | Een bestand of een map met precies deze naam, op elke diepte en in elke root. Met een schuine streep aan het einde geldt de regel alleen voor mappen. |
.DS_Store, updraft/
|
| Naam met ster | Een naam die zo begint of zo eindigt. Er is één ster toegestaan, aan het begin of aan het einde. |
*.log, backwpup*
|
| Pad | Een pad in een root. Het eerste deel is de naam van de root. De regel geldt voor het item en alles daaronder. | wp-content/cache |
Pad met **
|
** als heel deel staat voor willekeurig veel mappen, ook geen. |
wp-uploads/**/*.jpg |
Een pad begint met wp-content, wp-uploads, wp-plugins, wp-themes, wp-mu-plugins, wp-core of wp-root. Hoofdlettergebruik speelt geen rol.
# De geldende regels tonen wp cloneworx-backup scope exclusions # De lijst vervangen door drie eigen regels wp cloneworx-backup scope exclusions --set="wp-content/cache,*.log,.DS_Store" # De standaard herstellen wp cloneworx-backup scope exclusions --reset
De plugin controleert elke regel vóór het opslaan. Is een regel ongeldig, dan slaat hij niets op: het commando eindigt met een fout en vermeldt elke ongeldige regel met de reden. Na het opslaan toont het het aantal regels en de lijst die nu geldt. Het commando weigert een pad dat door de map van een andere root loopt; het toont de juiste schrijfwijze, bijvoorbeeld wp-uploads/videos in plaats van wp-content/uploads/videos.
Altijd uitgesloten
Welke regels ook gelden, de plugin sluit altijd uit: zijn eigen mappen, elke map met een bestand genaamd .donotbackup, een andere WordPress-installatie binnen jouw website en de cache- en logboekmappen die W3 Total Cache, WP Rocket, LiteSpeed Cache, Wordfence en WooCommerce voor zichzelf vastleggen.
Tabellen alleen als structuur back-uppen: scope tables
Sommige plugins houden tabellen bij voor sessies, logboeken, caches of statistieken die groot worden. Voor zulke tabellen kun je bepalen dat elke back-up alleen de structuur bewaart en de rijen weglaat. Standaard back-upt de plugin elke tabel volledig.
| Parameter | Betekenis | Toegestane waarden |
|---|---|---|
--structure-only |
Vervangt de lijst met tabellen waarvan alleen de structuur wordt bewaard. Een lege waarde leegt de lijst. | Namen van tabellen zonder voorvoegsel, gescheiden door komma’s |
--force |
Past de wijziging ook toe als een andere gebruiker dan de gebruiker aan wie de mappen van de plugin toebehoren. | zonder waarde |
De parameter werkt alleen samen met het deel tables.
# Twee tabellen alleen als structuur back-uppen wp cloneworx-backup scope tables --structure-only="woocommerce_sessions,wfHits" # De lijst leegmaken: weer elke tabel volledig back-uppen wp cloneworx-backup scope tables --structure-only=""
- De naam staat zonder het voorvoegsel van de tabellen:
woocommerce_sessions, nietwp_woocommerce_sessions. - Alleen tabellen van deze website zijn toegestaan. Geef je een tabel op die niet bestaat, dan slaat de plugin niets op, en het commando vermeldt de onbekende namen.
- De eigen tabellen van de plugin zijn niet te kiezen: daarvan wordt altijd alleen de structuur bewaard.
- Bij een herstel blijft zo’n tabel zoals die op de website is, met haar gegevens. Bestaat ze daar niet, dan maakt de plugin ze leeg aan.
Na het opslaan toont het commando het aantal tabellen en de lijst met alle tabellen met hun labels.