Natuurlijk! Hier is een stapsgewijze gids om een geavanceerd content-archiveringssysteem in Craft CMS op te zetten, gebaseerd op jouw criteria: ### Stap 1: Voorbereiding - **Zorg dat je een back-up hebt** van je database en bestanden. - **Controleer of je Craft CMS up-to-date is** om te profiteren van de nieuwste functies en beveiligingsupdates. ### Stap 2: Structuur en velden definiëren - Maak een nieuwe **Entry Type** of **Section** voor gearchiveerde inhoud, bijvoorbeeld “Archief” of “Gearchiveerd”. - Voeg indien nodig een **veld** toe (bijvoorbeeld een datumveld zoals “Archiefdatum”) om bij te houden wanneer een item is gearchiveerd. ### Stap 3: Automatisch archiveren op basis van leeftijd Gebruik een **cron-job** of **Craft’s Scheduled Tasks** (via de Control Panel of via een server cron) om periodiek oude blogberichten te archiveren. #### 3.1: Maak een plugin of gebruik een bestaande plugin voor scheduled tasks - Bijvoorbeeld, met [Plugin Store](https://plugins.craftcms.com/), kun je de plugin **"Freeform"** of **"Scheduler"** gebruiken, of je schrijft een eenvoudige custom plugin. #### 3.2: Voorbeeld van PHP-code voor het archiveren Plaats de volgende code in een aangepaste plugin of als een script dat je periodiek uitvoert: ```php use craft\elements\Entry; use craft\elements\db\ElementQuery; $thresholdDate = new \DateTime('-2 years'); $entries = Entry::find() ->section('blog') // Pas aan naar jouw blogsectie ->status('live') ->dateUpdated('<', $thresholdDate->format('Y-m-d')) ->all(); foreach ($entries as $entry) { // Maak een nieuwe gearchiveerde entry aan $archiefEntry = new Entry(); $archiefEntry->sectionId = /* ID van je 'Archief' sectie */; $archiefEntry->typeId = /* Type ID voor 'Gearchiveerd' */; $archiefEntry->title = $entry->title; $archiefEntry->setFieldValues($entry->getFieldValues()); // Kopieer velden indien nodig $archiefEntry->authorId = $entry->authorId; $archiefEntry->postDate = $entry->postDate; $archiefEntry->save(); // Verwijder of archiveer de originele $entry->delete(); } ``` > **Tip:** Vergeet niet om de juiste sectie- en type-IDs in te vullen. ### Stap 4: Gearchiveerde inhoud gemakkelijk beheren en terughalen #### 4.1: Gebruik een aparte sectie of categorie - Maak bijvoorbeeld een sectie “Archief” of voeg een veld toe dat aangeeft of een item gearchiveerd is, en filter daar op. #### 4.2: Een beheerpagina maken - Maak een template voor het tonen van gearchiveerde items, bijvoorbeeld: ```twig {% set archivedEntries = craft.entries() .section('archief') // of je gearchiveerde sectie .orderBy('postDate desc') .all() %} <ul> {% for entry in archivedEntries %} <li> <a href="{{ entry.url }}">{{ entry.title }}</a> <a href="{{ url('admin/entries/edit/' ~ entry.id) }}">Bewerken</a> <a href="{{ url('admin/entries/delete/' ~ entry.id) }}">Verwijderen</a> <a href="{{ url('restore/' ~ entry.id) }}">Terughalen</a> </li> {% endfor %} </ul> ``` #### 4.3: Gearchiveerde items terughalen - Voeg een functionaliteit toe (bijvoorbeeld via een Craft plugin of een custom action) om gearchiveerde items te herstellen: ```php // Bijvoorbeeld in een controller $archivedEntryId = craft::$app->request->getParam('id'); $archivedEntry = craft\elements\Entry::findOne($archivedEntryId); if ($archivedEntry && $archivedEntry->section->handle == 'archief') { // Maak een nieuwe live entry $restoredEntry = new Entry(); $restoredEntry->sectionId = /* ID van je 'blog' sectie */; $restoredEntry->typeId = /* Type ID voor 'Blog' */; $restoredEntry->title = $archivedEntry->title; // Kopieer velden $restoredEntry->setFieldValues($archivedEntry->getFieldValues()); $restoredEntry->save(); // Verwijder de gearchiveerde versie $archivedEntry->delete(); } ``` ### Stap 5: Automatisering en optimalisatie - Plan de archiveringsscript via een server cron-job of Craft’s Scheduled Tasks. - Zorg dat je voldoende logging hebt om fouten te monitoren. ### Stap 6: Veiligheid en gebruiksgemak - Beperk toegang tot de archiefbeheerpagina’s via gebruikersrechten. - Overweeg het gebruik van een plugin zoals [Sprout Modules](https://sprout.barrelstrengthdesign.com/) voor meer geavanceerde beheerfuncties. --- ### Samenvatting - Gebruik een aangepaste sectie voor gearchiveerde inhoud. - Automatiseer archivering met scripts en cron-jobs. - Maak beheerpagina’s voor overzicht en herstel. - Implementeer herstelprocessen via custom controllers of plugins. Heeft u specifieke vragen over de implementatie of wilt u hulp bij het schrijven van een complete plugin?

Absoluut! Hier is een complete, stapsgewijze handleiding voor het opzetten van een geavanceerd content-archiveringssysteem in Craft CMS, met behulp van native functies en plugins. ### Overzicht van de Aanpak We gaan dit realiseren met een combinatie van: 1. **Een custom veld "Archiveerstatus"**: Om de status van een entry bij te houden. 2. **Een native Craft CMS plugin (Elements API)**: Om een API-eindpunt te maken voor archivering. 3. **Een cronjob/server-side script**: Om het archiveringsproces automatisch uit te voeren. 4. **Een custom sectie "Gearchiveerd"**: Om gearchiveerde content gemakkelijk te beheren en terug te halen. --- ### Stap 1: Aanmaken van een Custom Veld en Sectie #### 1.1. Aanmaken van een Status Veld We voegen een veld toe om te tracken of een entry gearchiveerd is. * Ga in de Craft CP naar **Instellingen** -> **Velden**. * Maak een nieuw veld aan, kies het type **Dropdown**. * Naam: `Archiveerstatus` * Handle: `archiveerstatus` * Voeg de volgende opties toe: * Label: `Actief`, Waarde: `actief` * Label: `Gearchiveerd`, Waarde: `gearchiveerd` * Zet de standaardwaarde op `Actief`. * Sla het veld op. #### 1.2. Koppel het veld aan je Blogpost Sectie * Ga naar **Instellingen** -> **Secties** en bewerk je bestaande blogposts-sectie. * Voeg in het tabblad **Veldindeling** het nieuwe `Archiveerstatus` veld toe. * Sla de sectie op. #### 1.3. (Optioneel) Aanmaken van een "Gearchiveerd" Sectie Dit maakt het beheren en terugzetten veel gebruiksvriendelijker. * Ga naar **Instellingen** -> **Secties** -> **Nieuwe sectie**. * Naam: `Gearchiveerd` * Handle: `gearchiveerd` * Type: **Channel** * URI-indeling: `gearchiveerd/{slug}` * Template: `_archief/_entry` (je moet dit template later aanmaken) * Schakel **Niet in de sitemap opnemen** in. * Kies dezelfde veldindeling als je blogposts, inclusief het `Archiveerstatus` veld. * Sla de sectie op. --- ### Stap 2: Automatische Archivering Instellen We gaan een console command maken die via een cronjob wordt uitgevoerd. #### 2.1. Aanmaken van een Custom Module (Aanbevolen) Dit is de propere, onderhoudbare manier. Maak eerst een module aan via de Craft CLI: ```bash ./craft setup/app-id ./craft make/module mijn-module ``` Volg de instructies om de module in `config/app.php` te registreren. #### 2.2. Aanmaken van een Console Command In je module-map (bijv. `modules/mijnmodule/`), maak een bestand aan: `console/controllers/ArchiveerController.php`. ```php <?php namespace modules\mijnmodule\console\controllers; use Craft; use craft\console\Controller; use craft\elements\Entry; use craft\helpers\Console; use yii\console\ExitCode; class ArchiveerController extends Controller { public function actionIndex() { // Bereken de datum van 2 jaar geleden $tweeJaarGeleden = new \DateTime(); $tweeJaarGeleden->modify('-2 years'); // Zoek alle blogposts ouder dan 2 jaar die nog 'actief' zijn $entries = Entry::find() ->section('jeBlogSectionHandle') // VERVANG door je eigen sectie-handle ->status(null) // Zoek in alle statussen (incl. disabled) ->where(['{{%content}}.archiveerstatus' => 'actief']) // Controleer de status ->before($tweeJaarGeleden) ->all(); $this->stdout("Aantal te archiveren entries: " . count($entries) . PHP_EOL); if (empty($entries)) { $this->stdout("Niets om te archiveren." . PHP_EOL); return ExitCode::OK; } $elementsService = Craft::$app->getElements(); foreach ($entries as $entry) { // Update het statusveld naar 'gearchiveerd' $entry->setFieldValue('archiveerstatus', 'gearchiveerd'); // Optioneel: Verplaats de entry naar de "Gearchiveerd" sectie // $entry->sectionId = Craft::$app->getSections()->getSectionByHandle('gearchiveerd')->id; // Schakel de entry uit (zodat hij niet langer live is op de site) $entry->enabled = false; // Sla de wijzigingen op if ($elementsService->saveElement($entry)) { $this->stdout("Entry '{$entry->title}' succesvol gearchiveerd." . PHP_EOL, Console::FG_GREEN); } else { $this->stdout("Fout bij archiveren '{$entry->title}': " . implode(', ', $entry->getErrors()) . PHP_EOL, Console::FG_RED); } } $this->stdout("Archiveringsproces voltooid." . PHP_EOL); return ExitCode::OK; } } ``` * **VERVANG** `jeBlogSectionHandle` door de handle van je blog-sectie (bijv. `blog`). #### 2.3. Cronjob Instellen Voeg een regel toe aan de crontab van je server (`crontab -e`). Dit voert het script bijvoorbeeld elke nacht om 2:00 uit. ```bash # VERVANG /pad/naar/je/craft met het juiste pad 0 2 * * * /usr/bin/php /pad/naar/je/craft archiveer/index > /dev/null 2>&1 ``` --- ### Stap 3: Inhoud Terughalen en Beheren #### 3.1. Beheren via het Control Panel * **Zonder "Gearchiveerd" sectie**: Ga naar **Entries**. Je kunt filteren op het veld `Archiveerstatus: Gearchiveerd` om alles te zien. Klik op een entry, zet de status terug op `Actief` en schakel hem weer in (`enabled`). * **Met "Gearchiveerd" sectie**: Ga naar de **Gearchiveerd** sectie. Je ziet een overzicht van alles wat gearchiveerd is. Het terugzetten is nu simpel: dupliceer de entry, kies de originele blog-sectie, zet de status op `Actief`, en verwijder de originele gearchiveerde entry. #### 3.2. Aanmaken van een Terugzet-API (Optioneel, maar krachtig) Maak een custom controller in je module voor een REST API. `controllers/ApiController.php`: ```php <?php namespace modules\mijnmodule\controllers; use Craft; use craft\web\Controller; use craft\elements\Entry; use yii\web\Response; class ApiController extends Controller { protected $allowAnonymous = ['restore']; public function actionRestore($entryId) { $this->requirePostRequest(); $entry = Entry::find() ->id($entryId) ->status(null) ->one(); if (!$entry || $entry->archiveerstatus != 'gearchiveerd') { return $this->asJson(['success' => false, 'error' => 'Entry niet gevonden of niet gearchiveerd.']); } // Herstel de entry $entry->setFieldValue('archiveerstatus', 'actief'); $entry->enabled = true; if (Craft::$app->getElements()->saveElement($entry)) { return $this->asJson(['success' => true, 'message' => 'Entry succesvol teruggezet.']); } else { return $this->asJson(['success' => false, 'error' => 'Kon entry niet opslaan.']); } } } ``` Registreer een URL-regel in `config/routes.php`: ```php <?php return [ 'api/restore/<entryId:\d+>' => 'mijn-module/api/restore', ]; ``` Je kunt nu een POST-request sturen naar `/api/restore/123` om entry met ID 123 terug te zetten. --- ### Stap 4: Templates Aanpassen In je Twig-templates, zorg ervoor dat je alleen `actieve` entries toont. **Voorbeeld in een blogoverzicht:** ```twig {% set entries = craft.entries() .section('jeBlogSectionHandle') .archiveerstatus('actief') // Filter op de custom status! .all() %} {% for entry in entries %} { ... } {% endfor %} ``` ### Aanbevelingen en Best Practices 1. **Back-up**: Voer altijd een database-back-up uit voordat je automations zoals deze implementeert. 2. **Test grondig**: Test het archiveringsscript eerst op een development-omgeving. Gebruik de `--dry-run` vlag (die je zelf zou kunnen toevoegen aan de command) of pas de datum aan naar een paar dagen geleden voor testdoeleinden. 3. **Logging**: Voeg uitgebreide logging toe aan je console command. Craft's `Craft::info()`, `Craft::error()` logt naar `storage/logs/` wat erg handig is. 4. **Performance**: Voor zeer grote sites, overweeg dan om de batch-verwerking van Craft (`batch()` helper) te gebruiken in je command om memory limits te voorkomen. 5. **Gebruik Plugins (Alternatief)**: * **SEOMatic**: Heeft ingebouwde archiveringsfuncties voor SEO-doeleinden. * **Elements API**: Kan gebruikt worden om een custom archiverings-API te bouwen zonder een volledige module te maken, maar een console command heeft de voorkeur voor geplande taken. * **Super Table** / **Matrix**: Als je archivering complexer is (bijv. archiveren van individuele blokken), kun je deze veldentypes gebruiken voor meer controle. Dit systeem is robuust, schaalbaar en integreert naadloos met de native functies van Craft CMS. Het geeft je volledige controle over het archiverings- en herstelproces.