Smart Custom 404 error page [404page]

Bringing visitors to your website takes time and effort. Every visitor is important. The default 404 error page of most themes do not provide any information on what to find on your site. A first tme visitor, who does not know you, is left in a dead end and leaves your website. Set up a helpful custom 404 error page to keep him on your site.

This handy plugin allows you to easily create your own 404 error page without any effort and it works with almost every theme.

Retired Plugin

Development, maintenance and support of this plugin has been retired in october 2023. You can use this plugin as long as is works for you.

There will be no more updates and I won’t answer any support questions. Thanks for your understanding.

Feel free to fork this plugin.

Thanks

Many thanks to the more than 100,000 users of this plugin. You have made this plugin a huge success. It was a pleasure and an honor, but I am retiring from plugin development.

Best regards,
Peter

Usage

Create your custom 404 error page just like any other page using the WordPress Page Editor. Then go to ‘Appearance’ -> ‘404 Error Page’ and select the created page as your custom 404 error page. That’s it!

Why use this plugin?

Different from other similar plugins the 404page plugin does not create redirects. That’s quite important because a correct code 404 is delivered which tells search engines that the page does not exist and has to be removed from the index.

Different from other similar plugins the 404page plugin does not create additional server requests.

Requirements

The only requirement for this plugin is that you change the Permalink Structure in ‘Settings’ -> ‘Permalinks’ to anything else but ‘Plain’. This also activates the WordPress 404 error handling.

Block & Shortcode

Block

The Plugin offers a block “URL causing 404 error” for the block-based editor to show the URL that caused the error. The block offers three display options:

• “Page” to show the page including path ( e.g. does/not/exist )
• “Domain Path” to show the URL without protocol and parameters ( e.g. example.com/does/not/exist )
• “Domain Path” to show the URL without protocol and parameters ( e.g. example.com/does/not/exist )
• “Full” to show the complete URL ( e.g. https://example.com/does/not/exist?p=1 )

Shortcode

The Plugin offers a shortcode “pp_404_url” for the classic editor to show the URL that caused the error. There are three possible options:

• [pp_404_url page] to show the page including path ( e.g. does/not/exist )
• [pp_404_url domainpath] to show the URL without protocol and parameters ( e.g. example.com/does/not/exist )
• [pp_404_url] or [pp_404_url full] to show the complete URL ( e.g. https://example.com/does/not/exist?p=1 )

Plugin Privacy Information

• This plugin does not set cookies
• This plugin does not collect or store any data
• This plugin does not send any data to external servers

For developers

Action Hook

The plugin adds an action hook 404page_after_404 which you can use to add extra functionality. The exact position the action occurs after an 404 error is detected depends on the Operating Method. Your function must not generate any output. There are no parameters.

Constant

If the 404page plugin is installed and activated it defines the PHP constant PP_404. Check existence of it to detect the 404page plugin.

Functions

The Plugin provides the following functions:

• pp_404_is_active() to check if there is a custom 404 page selected and the selected page exists
• pp_404_get_page_id() to get the ID of the 404 page
• pp_404_get_all_page_ids() to get an array of page IDs in all languages
• pp_404_get_the_url( $type ) to get the URL that caused the 404 error
  • Parameter $type string Optional
  • “page” to get the page including path ( e.g. does/not/exist )
  • “domainpath” to get the URL without protocol and parameters ( e.g. example.com/does/not/exist )
  • “full” (default) to get the complete URL ( e.g. https://example.com/does/not/exist?p=1 )

Native Mode

If you are a theme developer you can add native support for the 404page plugin to your theme for full control.