Instellingen en omvang met WP-CLI

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 noemt De opdrachten in één oogopslag.

Wat bij een back-upplan of bij een doel hoort, staat niet hier: dat 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 noemt een sleutel en zijn waarde. (default) achter 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 noemt de laatste regel het adminadres van de website: daar gaan de meldingen naartoe.

Een instelling lezen en zetten: settings get, set

settings get geeft de waarde van een sleutel uit. settings set slaat een nieuwe waarde op. Sleutel en waarde staan zonder parameter achter 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 goede 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 noemt 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 noemt de toegestane grenzen.
email	Een adres is geen geldig e-mailadres.
too_many	Het zijn meer dan 5 adressen.

Wat elke instelling doet, legt De pagina “Instellingen” uit.

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.

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

De omvang tonen: scope

De omvang zegt wat bij jouw website hoort: welke mappen, welke tabellen van de database en wat wordt weggelaten. scope toont die. Het deel achter scope kiest 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 noemt 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 zonder opgave.

# 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. De plugin back-upt het bestand, maar zet het bij een herstel nooit terug.
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 hoofdmap van de website, bijvoorbeeld .htaccess en robots.txt.

Uitsluitingsregels zetten: scope exclusions

Uitsluitingsregels gelden voor de hele website en voor elk back-upplan. Wat een regel treft, komt in geen enkele back-up.

Parameter	Betekenis	Toegestane waarden
--set	Vervangt de hele lijst met regels door de genoemde.	Regels, gescheiden door komma’s
--reset	Herstelt de standaard.	zonder waarde
--force	Zet ook 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 drie vormen:

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 treft de regel alleen mappen.	.DS_Store, updraft/
Naam met ster	Een naam die zo begint of zo eindigt. Toegestaan is één ster, 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 treft het item en alles daaronder.	wp-content/cache

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 noemt elke ongeldige regel met de reden. Na het opslaan noemt het het aantal regels en toont het de lijst die nu geldt.

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	Zet ook 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, niet wp_woocommerce_sessions.
• Toegestaan zijn alleen tabellen van deze website. Noem je een tabel die niet bestaat, dan slaat de plugin niets op, en het commando noemt 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 noemt het commando het aantal tabellen en toont het de lijst met alle tabellen met hun labels.

Zie ook

• De pagina “Instellingen”
• Bepalen wat er wordt geback-upt
• E-mailmeldingen instellen
• De plugin aanpassen aan je server
• De plugin verwijderen