Name

SpecialPage — specify location of special pages

SYNOPSIS

type filename ...

DESCRIPTION

Specify custom values for Interchange special pages.

Valid types are:

  • badsearch — Defaults to badsearch, displayed if search initialization failed.

  • canceled — default page for the cancel form action.

  • catalog — Defaults to .

  • failed — Standard handler for failed orders.

  • flypage — Defaults to flypage.

  • interact — Called on various errors, including missing FormActions. Defaults to interact.

  • missing — Defaults to missing.

  • needfield — Defaults to .

  • order — Defaults to ord/basket.

  • put_handler — Standard handler for PUT operations.

  • receipt — Default page displayed as order receipt.

  • results — Defaults to results.

  • salestax.asc — Defaults to salestax.asc.

  • search — Defaults to results.

  • shipping.asc — Defaults to shipping.asc.

  • violation — Defaults to .

DIRECTIVE TYPE AND DEFAULT VALUE

Catalog directive

EXAMPLES

Example: Setting SpecialPage

SpecialPage  catalog        index
SpecialPage  violation      special/violation
SpecialPage  put_handler    admin_publish
SpecialPage  receipt        ../etc/receipt
SpecialPage  badsearch      special/badsearch
SpecialPage  catalog        test
SpecialPage  canceled       special/canceled
SpecialPage  failed         special/failed
SpecialPage  interact       special/interact
SpecialPage  missing        special/missing
SpecialPage  needfield      special/needfield
SpecialPage  order          ord/basket
SpecialPage  search         results
SpecialPage  violation      special/violation

Example: Setting SpecialPage

SpecialPage catalog   index
SpecialPage target    index
SpecialPage missing   not_found
SpecialPage violation not_found
SpecialPage order     cart

NOTES

AVAILABILITY

SpecialPage is available in Interchange versions:

4.6.0-5.9.0 (git-head)

SOURCE

Interchange 5.9.0:

Source: lib/Vend/Config.pm
Line 573

['SpecialPage',     'special', 'order ord/basket results results search results flypage flypage'],

Source: lib/Vend/Config.pm
Line 3168 (context shows lines 3168-3180)

sub parse_special {
my($item,$settings) = @_;
return {} unless $settings;
my(%setting) = grep /\S/, split /[\s,]+/, $settings;
for (keys %setting) {
  if($Global::NoAbsolute and file_name_is_absolute($setting{$_}) ) {
    config_warn("Absolute file name not allowed: %s", $setting{$_});
    next;
  }
  $C->{$item}{$_} = $setting{$_};
}
return $C->{$item};
}

AUTHORS

Interchange Development Group

SEE ALSO

DirectoryIndex(7ic), SpecialPageDir(7ic)

DocBook! Interchange!