Maintenance Page

Gratis
v2.0.14 Eeuwigdurende licentie Updated 5 jun. 2026

Maintenance Page

Affichez une page CMS personnalisée pendant la maintenance Magento, au lieu du 503.php standard. IP whitelist, URL de bypass secrète, accès admin préservé.
Gratis Hyvä Compatibel Magento 2.4.4 Magento 2.4.5 Magento 2.4.6 Magento 2.4.7 Mage-OS 2.0 Mage-OS 2.1
Gratis
Probeer de live demo
  • Updates and support included for 12 months
  • Full documentation included
  • Compatible with Hyvä themes
  • Composer-ready installation

Maintenance — Free Edition

Vervang de standaard 503.php van Magento door een echte, gebrande CMS-pagina tijdens onderhoudsvensters. De free edition is de no-frills-optie: kies een CMS-pagina, stel een bypass-secret in of whitelist uw kantoor-IP's, en uw klanten zien een nette pagina in plaats van een ruw error-template zodra u maintenance mode aanzet.

De plugin haakt in op het catchException-flow van Magento, dus hij wordt geactiveerd op exact het moment dat de native bin/magento maintenance:enable de 503 zou hebben getoond — geen extra cron, geen scheduling, geen verrassingen. Een ingebouwd Engels fallback-template dekt het geval waarin de geconfigureerde CMS-pagina ontbreekt.

Voor wie

  • Handelaars die een nette maintenance-pagina willen zonder voor de Pro-editie te betalen
  • Stores die onderhoud handmatig plannen via bin/magento maintenance:enable en een beter klantgericht scherm willen
  • Bureaus die deploys voorbereiden voor klanten die hechten aan merkconsistentie, zelfs tijdens downtime

Belangrijkste voordelen

  • Custom CMS-pagina — kies elke CMS-pagina in de admin; de module rendert hem met frontend area code, dus blocks en widgets werken.
  • IP-whitelist (exact match) — laat uw kantoor, monitoring of CI maintenance bypassen. CIDR-ranges zijn een Pro-feature.
  • Bypass secret URL — deel een ?maintenance_bypass=YOUR_SECRET-link met staff en externe testers. Versleuteld opgeslagen in de admin config.
  • Admin-toegang toggle — houd het admin panel optioneel bereikbaar tijdens maintenance zodat u het werk kunt afmaken.
  • HTTP-status configureerbaar — retourneer 503 (default, correct voor SEO), 200 of 302 afhankelijk van het gebruik. Configureerbare Retry-After-header.
  • Stille logging in productie — interne traces achter een admin-debug-toggle, zodat system.log niet gespammed wordt door PHP 8.2/8.3-deprecation-notices die defensief door de plugin worden opgevangen.
  • MIT-licentie — installeer op zoveel stores als u wilt, pas het template vrij aan.

Compatibiliteit

  • Magento 2.4.x / Mage-OS equivalent
  • PHP 8.1, 8.2, 8.3
  • Vereist wimakeit/module-core 3.0.9 of hoger
  • Ingebouwd Engels template — meertalige templates, scheduled maintenance, pre-maintenance banner, Hyvä-/Breeze-support en CIDR-whitelist zitten in wimakeit/module-maintenance-pro

Installeer deze module via Composer. Zorg ervoor dat uw auth.json is geconfigureerd met uw Wimakeit-inloggegevens.

Terminal 
$ composer require wimakeit/module-maintenance:^2.0.14
$ bin/magento setup:upgrade
$ bin/magento setup:di:compile

Installation notes

The standard composer require + setup:upgrade + setup:di:compile flow applies. The points below cover what's specific to this module.

Required dependency

This module requires wimakeit/module-core 3.0.9 or later. Composer will pull it automatically from the Wimakeit registry as long as the registry is declared in your project's composer.json.

ACL permissions

After installation, one ACL resource is registered under System → Permissions → User Roles:

ResourceDefault
Wimakeit_Maintenance::config (edit module configuration)granted to Administrator role only

Default CMS page

A CMS page with identifier site-under-maintenance is created automatically by the install patch (chosen to avoid url_rewrite collisions with existing categories/products named "maintenance"). You can:

1. Edit it in Content → Pages to customize the look 2. Create your own CMS page and select it in the admin config 3. Leave it empty and let the built-in English fallback template render

Configuration

The module ships disabled (opt-in). Go to Stores → Configuration → Wimakeit → Maintenance.

General settings

SettingDefault
Enable Custom Maintenance PageNo (opt-in)
CMS Pagesite-under-maintenance
Use Fallback TemplateYes
HTTP Status Code503
Retry-After (seconds)3600
Allowed IPs(empty — exact match only; CIDR in Pro)
Bypass Secret Key(empty; min 8 characters recommended, stored encrypted)
Apply to Admin PanelNo (admin remains accessible)
Enable Debug LoggingNo — leave off in production

Usage

# Enable maintenance (native Magento command)
bin/magento maintenance:enable

# Enable with IP whitelist on the fly
bin/magento maintenance:enable --ip=192.168.1.100 --ip=10.0.0.1

# Disable
bin/magento maintenance:disable

# Status + troubleshooting (Wimakeit-specific)
bin/magento wimakeit:maintenance:status

Bypass during maintenance

Add your bypass secret to any URL:

https://yourstore.com/?maintenance_bypass=YOUR_SECRET_KEY

The check is timing-attack safe.

Custom template

Override the default template by creating one in your theme:

app/design/frontend/<Vendor>/<theme>/Wimakeit_Maintenance/templates/maintenance/content/en.phtml
app/design/frontend/<Vendor>/<theme>/Wimakeit_Maintenance/templates/maintenance/styles/default.phtml
Versie
v2.0.14
Licentie
Eeuwigdurende licentie
Ondersteuning
12 maanden
Last updated
5 jun. 2026
Magento
Magento 2.4.4 Magento 2.4.5 Magento 2.4.6 Magento 2.4.7 Mage-OS 2.0 Mage-OS 2.1
PHP
PHP 8.1 PHP 8.2 PHP 8.3
Hyvä
Compatibel
Pakket
wimakeit/module-maintenance

Compatibility checker

Pick your stack to see if this module fits.

Compatibiliteit 4

Ja. Maintenance Page is getest tegen Magento Open Source 2.4.4 → 2.4.7, Adobe Commerce op dezelfde lijn, en Mage-OS 2.0+ — op PHP 8.1, 8.2 en 8.3. Het tabblad Specificaties toont de geteste combinaties. Staat uw stack erbij, dan garanderen wij een schone installatie. Wimakeit is een Adobe-gecertificeerd Magento-bureau in Presles, Wallonië (tussen Charleroi en Namen), België — elke module wordt getest op dezelfde matrix die we naar onze enterprise-klanten in België, Frankrijk en Nederland uitrollen.
Ja — volledig. Maintenance Page bevat een native Hyvä-compatibele frontend (Tailwind + Alpine.js) en integreert met Hyvä Checkout waar van toepassing. Geen extra fallback-module nodig. Elke Hyvä-gemarkeerde module wordt gebouwd door hetzelfde Wimakeit-team dat Hyvä-migraties in productie uitvoert.
Hyvä Storefront (Tailwind + Alpine.js, server-rendered) en Hyvä Checkout (React-gebaseerd, headless bovenop Magento) zijn twee aparte pakketten. Maintenance Page bevat native Hyvä Storefront-compatibiliteit — de frontend wordt gerenderd via Hyvä-templates, zonder Luma-fallback. Hyvä Checkout-integratie wordt geleverd wanneer de module een raakvlak heeft met een checkout-stap (custom betaalinput, voorwaarden-checkbox, ...); anders draait de module server-side zonder Hyvä Checkout-aanpassing. Zie het tabblad Specificaties voor de exacte Hyvä-scope van deze module.
Ja. Maintenance Page respecteert het standaard Magento-scope (default / website / store / store_view). Elke configuratie is overschrijfbaar per store view. Frontend-labels gebruiken de standaard Magento-vertaalbestanden — by-default in het Nederlands, Frans en Engels. Valuta's volgen uw Magento-valutaconfiguratie zonder extra werk. Een typische Wimakeit Magento-webshop draait een fr_BE / nl_BE / en_GB-triplet vanuit één backend — Maintenance Page is klaar voor deze B2B / internationale setup.

Prijs & licentie 4

Maintenance Page is gratis voor Wimakeit-klanten. De licentie dekt 1 productiedomein + 1 staging/dev-domein. Premium support, maatwerk en SLA-upgrades op aanvraag — het Waalse Magento-team van Wimakeit (Presles, tussen Charleroi en Namen) is Adobe Commerce-gecertificeerd sinds 2021.
Ja. Maintenance Page heeft een live demo op demo.wimakeit.be/module-maintenance waar u admin en frontend kan verkennen met een echte installatie inclusief sample data. Voor langere evaluaties vraagt u een evaluatielicentie aan via ons contactformulier — de evaluatie dekt dezelfde scope als de betaalde licentie en wordt na aankoop omgezet in een permanente sleutel.
Geen betaling om terug te storten — Maintenance Page is gratis. Past het niet, dan schakelt u de module uit met bin/magento module:disable; opruimen gebeurt automatisch via de revert van de setup patch.
Maintenance Page wordt verspreid onder een commerciële proprietary licentie — geen MIT, GPL of andere open-source licentie. De PHP-broncode komt na composer require in vendor/wimakeit/ terecht; u kan ze lezen, auditen en lokaal patchen voor uw eigen Magento-installatie. U mag de code NIET herverspreiden, sublicentiëren, op een publiek Composer-register publiceren of doorverkopen. Eén licentie = één productiedomein + één staging/dev-domein (zie de algemene voorwaarden voor de volledige EULA). Wimakeit-modules staan NIET op het publieke packagist.org — ze worden uitsluitend verspreid via het private Composer-register packages.wimakeit.be.

Installatie & updates 6

Voer composer require wimakeit/module-maintenance:^2.0.12 uit, daarna bin/magento setup:upgrade, bin/magento setup:di:compile en tot slot bin/magento cache:flush. Het tabblad Installation op deze pagina lijst elke configuratiestap (ACL's, crons, defaultwaarden) — een deploy duurt minuten, geen uren. Hulp nodig? Wimakeit biedt Magento-installatiediensten vanuit ons Waalse kantoor (Presles, tussen Charleroi en Namen).
Stap 1: haal een token op via packages.wimakeit.be → Mijn account → Tokens. Stap 2: voeg in de root van uw project aan auth.json toe: {"http-basic": {"packages.wimakeit.be": {"username": "UW-E-MAIL", "password": "UW-TOKEN"}}}. Stap 3: registreer het repo: composer config repositories.wimakeit composer https://packages.wimakeit.be. Stap 4: composer require wimakeit/module-maintenance:^2.0.12. In CI/CD-pipelines injecteert u COMPOSER_AUTH als JSON-environment-variabele in plaats van auth.json te commit'en.
De meeste merchants zijn binnen 30 minuten live: composer install (1-2 min) → setup:upgrade + di:compile (5-10 min afhankelijk van de stack) → adminconfiguratie (5-15 min volgens het Installation-tabblad) → smoke test op een product of order. Reken meer tijd als u een custom theme heeft dat vergelijkbare templates overschrijft. Het Wimakeit-team heeft deze module geleverd aan B2B- en DTC-shops in heel België.
Maintenance Page is ontworpen voor Magento 2.4.x / Mage-OS 2.0+ en heeft geen Magento 1-equivalent. Bij een migratie vanaf Magento 1 neemt het Wimakeit-team de audit, datamigratie en integratie van Maintenance Page in de nieuwe backoffice voor zijn rekening, in het kader van een Magento-migratieproject. De overstap van Adobe Commerce naar Mage-OS is transparant voor Maintenance Page: zelfde composer require, zelfde modulecode, zelfde databaseschema — geen fork om te onderhouden, geen licentiewijziging.
Updates lopen via uw composer-dependency (exact dit pakket), gehost op het private Composer-register van Wimakeit op packages.wimakeit.be. Elke release wordt aangekondigd op het Changelog-tabblad + het Wimakeit-nieuws en volgt semver — composer update blijft veilig binnen een major.
Alle .phtml-templates zijn overschrijfbaar vanuit uw theme: kopieer het bestand naar app/design/frontend/{UwVendor}/{theme}/Wimakeit_{Module}/templates/ met hetzelfde relatieve pad. Blocks, ViewModels en Helpers worden overschreven via DI-preference in uw eigen custom module — declareer <preference for="Wimakeit\…\OriginalClass" type="UwVendor\Override\Class" /> in etc/di.xml. Layout-XML wordt uitgebreid (voorkeur) of overschreven op de standaard Magento-manier. Wimakeit-modules gebruiken nooit het keyword final op klassen die u redelijkerwijs zou willen override — overschrijven is een first-class scenario, geen hack.

Support & beveiliging 3

Open een ticket via het contactformulier op wimakeit.be of mail contact@wimakeit.com met modulenaam, versie, Magento/Mage-OS-versie en reproduceringsstappen. Fixes verschijnen in de volgende patch. Wimakeit-support antwoordt in het Nederlands, Frans en Engels op werkdagen (CET-uren).
Stuur security-rapporten privé naar contact@wimakeit.com met het voorvoegsel [SECURITY] in het onderwerp — vermeld de module, versie en reproductiestappen. Bevestiging op werkdagen, vermelding in het Changelog op verzoek. Wimakeit is een Belgische BV (besloten vennootschap) onderworpen aan Belgisch en Europees recht inzake privacy en responsible disclosure.
Ja. Maintenance Page bewaart uitsluitend data binnen zijn functionele scope, volgt nooit shoppers over verschillende sites, en doet by-default geen enkele externe call. Combineer met de Wimakeit GDPR-module voor cookiebanners en data-subject request forms conform Belgische, Franse en Nederlandse DPA-richtlijnen. De hostingpartners van Wimakeit (OVH Roubaix / Gravelines, Cblue Gembloux) houden alle klantdata binnen de EU.

Over Wimakeit 1

Wimakeit is een Adobe-gecertificeerd Magento-bureau in Presles, Wallonië (tussen Charleroi en Namen), België, dat sinds 2020 Magento- en Mage-OS-webshops bouwt voor klanten in BE / FR / NL. Elke module op deze marketplace draait in productie bij minstens één Wimakeit-klant (we eat our own dogfood). Directe lijn met de ontwikkelaars die de code hebben geschreven, meertalige support (NL / FR / EN), CET-werkuren, geen offshore. Bekijk onze referenties voor het soort Magento-projecten dat wij opleveren.

Iets gevonden dat niet in de FAQ staat?

Meld een bug of stel een vraag — het formulier is voor-ingevuld met deze module.

Een bug melden

Changelog

Categories: Security, Feature, Fix, Perf, Admin, Deps.

[2.0.12] - 2026-05-26

Fix

  • Default CMS page identifier changed from maintenance to site-under-maintenance to avoid url_rewrite collisions with categories/products commonly named "maintenance".
  • Install patch now checks for existing url_rewrite entries before saving; on conflict it logs a warning and skips gracefully instead of crashing setup:upgrade with a duplicate-URL-key error.

Admin

  • Existing installs keep their previous CMS page; only fresh installs get the new safer default identifier.

[2.0.10] - 2026-05-26

Fix

  • CMS page creation patch reduced to the essential fields, removing legacy attributes that could cause setup:upgrade to fail on stores with stricter EAV validators.

[2.0.9] - 2026-05-10

Admin

  • Debug logging now routes through a shared Wimakeit\Maintenance\Logger\DebugLogger virtualType — cleaner code, no behavior change. The toggle path wimakeit_maintenance/general/debug_mode is unchanged.
  • The defensive \Throwable catch in HttpPlugin no longer writes critical lines for upstream PHP deprecation notices; demoted to warning and gated behind the debug toggle.

Deps

  • Requires wimakeit/module-core 3.0.9+ for the shared debug logger and inherited getConfigSection() helper.

[2.0.8] - 2026-05-10

Feature

  • New Enable Debug Logging admin toggle (General → Settings, default off). Keeps var/log/system.log quiet in production by gating internal info/debug/warning traces.

Fix

  • HttpPlugin no longer writes a CRITICAL line on every backend error path. PHP 8.2/8.3 dynamic-property deprecations in pub/errors/processor.php, caught defensively by aroundCatchException, are now gated behind the debug toggle. Hard errors that block functionality are still logged.

[2.0.2] - 2026-03-04

Admin

  • Breaking: Removed redundant wimakeit:maintenance:enable and wimakeit:maintenance:disable CLI commands. Use native bin/magento maintenance:enable / :disable. Diagnostics live in wimakeit:maintenance:status.
  • Default enabled changed from 1 to 0 (opt-in). The module must now be explicitly enabled in admin config before it intercepts requests.

[2.0.1] - 2026-03-04

Feature

  • New wimakeit:maintenance:status CLI command for status output and troubleshooting tips.

Fix

  • Plugin interception point moved from launch to catchException to correctly handle the maintenance exception thrown by Magento's Bootstrap.
  • Frontend area code is now set before rendering CMS content (fixes "area code not set" errors).
  • HttpResponse singleton pollution fixed via a factory pattern.
  • Added Cache-Control headers to prevent caching of the maintenance response.

[2.0.0] - 2026-03-03

Feature

  • Freemium split: free edition keeps the essentials, Pro edition adds scheduled maintenance, pre-maintenance banner, Hyvä/Breeze themes, multilingual templates, CIDR whitelist and license management.
  • License changed from proprietary to MIT for the free edition.

Admin

  • IP whitelist now supports exact match only (CIDR moved to wimakeit/module-maintenance-pro).
  • Single English template (multilingual templates moved to Pro).
  • Default Luma styling only (Hyvä/Breeze moved to Pro).

[1.1.0] - 2026-03-03

Feature

  • Scheduled maintenance with start/end date-time.
  • Pre-maintenance warning banner on the frontend.
  • Admin preview button to render the maintenance page without enabling maintenance.
  • New cron job wimakeit_maintenance_schedule_check running every minute.

[1.0.0] - 2026-03-03

Feature

  • Initial release.
  • Custom CMS page rendered during maintenance instead of 503.php.
  • Admin configuration panel at Stores → Configuration → Wimakeit → Maintenance.
  • IP whitelist with CIDR notation (IPv4 and IPv6).
  • Bypass secret URL parameter (timing-attack safe).
  • Configurable HTTP status codes (503, 200, 500, 502, 504) and Retry-After header.
  • CLI commands wimakeit:maintenance:enable / :disable.
  • Multilingual CMS pages per store view.
  • Theme-specific styling for Luma, Hyvä and Breeze.

Een bug gevonden? Laat het ons weten.

Een kort formulier opent in een nieuw tabblad — de modulenaam en uw taal zijn al ingevuld. Beschrijf wat u probeerde, wat misging, en wij komen binnen één werkdag bij u terug.

Een bug melden voor Maintenance Page
Module SKU: wimakeit-module-maintenance · Taal: nl_NL

Hulp nodig?

Ons team helpt u graag met de integratie.

Neem contact op
Planifier un appel