Jak povolit režim ladění ve WordPressu

Aktivace režimu ladění vyžaduje úpravu jednoho souboru ve vaší instalaci WordPressu. Je to jednoduché, ale je nutné postupovat opatrně, abyste web nerozbili. Níže najdete krok za krokem návod, jak to udělat správně.

Po aktivaci budete moci zaznamenávat chyby, skrývat je před návštěvníky a ovládat, jak WordPress zpracovává informace o ladění. To je obzvláště důležité na produkčních webech, kde chcete, aby se chyby ukládaly, ale nebyly veřejně zobrazovány.

Vyhledání souboru wp-config.php

Prvním krokem k zapnutí režimu ladění je nalezení souboru wp-config.php. Tento soubor se nachází v kořenové složce vaší instalace WordPressu, ve stejné složce, kde jsou wp-content, wp-includes a wp-admin. Přístup k němu můžete získat pomocí FTP programu, správce souborů v ovládacím panelu hostingu nebo lokálně, pokud pracujete na vývojovém serveru.

Před provedením změn se doporučuje vytvořit zálohu tohoto souboru. I jediný chybějící znak může váš web poškodit, a záloha vám umožní okamžitě jej obnovit. Jakmile soubor najdete, otevřete ho v textovém editoru a připravte se na úpravu konfigurace.

Aktivace WP_DEBUG

V souboru wp-config.php sjeďte dolů, dokud nenajdete řádek, který vypadá takto: define( 'WP_DEBUG', false );. Tento řádek určuje, zda je režim ladění aktivní. Ve výchozím nastavení je ve WordPressu ladění vypnuto z důvodů bezpečnosti a výkonu. Chcete-li jej zapnout, stačí změnit hodnotu z false na true.

Správný řádek by měl vypadat takto: define( 'WP_DEBUG', true );. Po uložení souboru začne WordPress okamžitě zobrazovat PHP varování, upozornění a chybové zprávy na celém webu. Díky tomu můžete identifikovat problematické pluginy, šablony nebo vlastní kód.

Použití WP_DEBUG_LOG pro zaznamenávání chyb

Zobrazení chyb na obrazovce může být při vývoji užitečné, ale není vždy praktické. Pro dlouhodobé sledování můžete zapnout WP_DEBUG_LOG. Chcete-li to provést, přidejte následující řádek hned pod konstantu WP_DEBUG: define( 'WP_DEBUG_LOG', true );. Tímto se všechny chyby uloží do souboru debug.log ve složce wp-content.

Logovací soubor je obzvláště užitečný, pokud potřebujete sledovat chyby, které se objevují v určitých okamžicích, nebo které nemůžete přímo reprodukovat na obrazovce. Také vám umožní sdílet soubor s vývojáři nebo týmem podpory bez přímého přístupu k webu.

Skrývání chyb před návštěvníky

Pokud je váš WordPress web naživo, pravděpodobně nechcete, aby návštěvníci viděli surové chybové zprávy. V takovém případě můžete přidat další nastavení, které vypne jejich zobrazování na frontendu: define( 'WP_DEBUG_DISPLAY', false );. To zajistí, že chyby budou stále zaznamenávány, ale nebudou viditelné pro uživatele.

Dále můžete přidat @ini_set( 'display_errors', 0 );, abyste toto chování posílili. Tato kombinace udrží váš web profesionální a bezpečný, zatímco potřebné informace budou k dispozici v logu pro administrátory a vývojáře.

Pokročilé ladění pomocí SCRIPT_DEBUG

Pro vývojáře pracující s JavaScriptem a CSS nabízí WordPress další konstantu: define( 'SCRIPT_DEBUG', true );. Ve výchozím nastavení WordPress načítá minifikované verze skriptů a stylů. Při zapnutí script-debuggingu WordPress načte plné, neminifikované verze, které se snáze kontrolují a ladí.

Toto nastavení je cenné, pokud vyvíjíte šablony nebo pluginy a potřebujete sledovat chování skriptů a stylů. Pro běžné uživatele obvykle není potřeba, ale pro vývojáře může mít velký význam při řešení problémů na frontendu.

Stručně řečeno, zapnutí režimu ladění ve WordPressu je jednoduchý, ale účinný způsob, jak diagnostikovat a spravovat svůj web. Úpravou souboru wp-config.php můžete zobrazovat chyby, ukládat je do logů a udržovat profesionální vzhled webu i při výskytu problémů. Správně používaný režim ladění je jedním z nejdůležitějších nástrojů pro udržení bezpečného, stabilního a přívětivého WordPressu pro vývojáře.