Generate alert on page not found with specified parameters in URL.
Version 1.0.7-pl
Release date 10.30.2018
Downloads 33
Views 1 554
Warning! This component requires PHP version 5.6 or higher! If your site uses PHP less than required, the installation of this package could break it.
Warning! This package requires MODX not less than 2.3 !
NotFoundParamAlert is MODx Revolution plugin which generate alert on page not found with specified parameters in URL. It is possible to select a range of URL parameters through using wildcards. The user can be notified through MODx logging system or email.

Useful to catch wrong URLs on large context advertising projects with UTM or other URL parameters. For example, to catch all not found pages with UTM and OpenStat parameters you can use the follow construction: utm_*,_openstat.

After installation use System settings notfoundparamalert namespace to set preferable settings values.

Available system settings (namespace notfoundparamalert):
parameters – list of URL parameters, separated by coma, which will generate alert. Available simple wildcards:? — one any symbol, * — group of symbols.
parameters_all – include in alert message all URL parameters or only matching parameters.
alert_method – alert method. Available values: «mail» – send alert message on email, «log» – log alert message.
alert_log_level – alert logging log level. Available values: «error», «warn», «info», «debug».
mail_method – send mail method. Available values: «php» – native php mail() function, «modx» – MODX mailer.
mail_from – valid email from which alert messages will be send.
mail_to – valid email where alert messages will be send.

In Lexicon notfoundparamalert namespace it is possible to set up your own template for log/email message.

Available placeholders used in message/mail text:
alertName — component name.
alertMethod — alert method.
siteName — site name ('site_name').
siteUrl — site url ('site_url').
urlPath — page relative URL.
urlFull — page absolute URL.
requestParams — matched URL parameters.
ipAddress — IP address the page was requested.

Feel free to suggest ideas/improvements/bugs on GitHub:


  • Add database support
  • Add CMP page
  • Add getRemote() function
  • Build script update
  • Some refactoring
  • Update lexicon files and docs


  • Bugfix show alert_method message/mail text
  • More informative alert_method on mail


  • Add trim to options list
  • Add warning on wrong alert_method/_level
  • Remade get/use alert_method logic
  • Remove "both" alert_method parameter
  • Some code optimization
  • Update lexicon files and docs


  • Rename email_to system settings
  • Add mail_method choice option
  • Add mail_from option
  • Update lexicon files and docs


  • Remove FATAL log level
  • Add component alert_name option
  • Add fillable alert message/mail text
  • Update lexicon files and docs
  • Bug fix


  • Add simple wildcard parameters match
  • Some code optimization
  • Update lexicon files


  • Add include all URL parameters or not option
  • Add log level choice option
  • Update lexicon files


  • Initial release