Perl Roff Perl6 HTML CSS SQLPL Other
Latest commit 6c8dea8 Feb 10, 2017 @jonjensen jonjensen Correct typo
Failed to load latest commit information.
SPECS Stamp updated copyright dates and version numbers Jan 6, 2016
code * Add ability to create multiple links with the explicit_edit parameter. Feb 1, 2017
debian Fix some inconsistencies in UTF-8 capitalization Oct 5, 2016
dist Add usernick to metadata for UserDB views Feb 2, 2017
eg Remove admin/test_code.html page Dec 5, 2015
extensions Fix typos in interpolate argument and remove stray trailing whitespace Nov 1, 2016
lib/Vend Fixed a bug in the [area] tag when a full URL is passed as the href. Feb 10, 2017
scripts Remove CVS keywords from other files changed going into 5.10.0 Apr 29, 2016
share/interchange-5 provide CSS style for mv_contrast class Nov 23, 2009
t Revert recent RobotUA changes until fully baked Jan 18, 2017
.gitignore Ignore more editor swap & backup files Apr 28, 2016
.travis.yml have Travis run prove for unit tests Jul 20, 2016
LICENSE Update LICENSE with fresh copy from the FSF at… Mar 30, 2007
MANIFEST Remove cart component from MANIFEST Oct 13, 2016
MANIFEST.SKIP Escape the other literal . in filename regex match Jul 7, 2016
Makefile.PL * Don't make the archaic .~* file copies if we detect any kind Jan 22, 2017
README Add cpanfile and instructions in README Jul 5, 2016
README-DEVELOPMENT Increase version number to 5.7.3 Oct 27, 2009
README.debian moved CSS and image files for UI from /var/www/interchange-5 to Oct 29, 2009
README.rhel * Remove unneeded version numbers. Mar 23, 2014
README.rpm-dist Stamp updated copyright dates and version numbers Jan 6, 2016
UPGRADE Correct typo Feb 10, 2017
WHATSNEW-4.5 Add separate files for each development stage of Interchange. Apr 9, 2004
WHATSNEW-4.7 * Remove [/page] and [/order] from a couple of obscure places. Mar 27, 2006
WHATSNEW-4.9 * Re-created the missing 5.0.1 entries. Apr 18, 2004
WHATSNEW-5.1 Add separate files for each development stage of Interchange. Apr 9, 2004
WHATSNEW-5.10 Add release notes for changes since 5.10.0 Apr 29, 2016
WHATSNEW-5.11 Add "promote_admin" option, to be used with "scratch". The option is … Jan 23, 2017
WHATSNEW-5.3 * Updates to WHATSNEW should include most major 2005 feature additions. Dec 8, 2005
WHATSNEW-5.5 Note Vend::Swish change, and upgrade ramifications of removed extra/ … May 17, 2008
WHATSNEW-5.7 Move 5.8 WHATSNEW to its own file Jul 7, 2014
WHATSNEW-5.8 update WHATSNEW for new release Jan 6, 2016
configure Stamp updated copyright dates and version numbers Jan 6, 2016
cpanfile Bundle::LWP is not a thing anymore; replace with: Aug 22, 2016 Correct detection of broken getppid() for Perl 5.10.0 (RT #286) Jun 27, 2009 * Add LSB=1 option to Makefile.PL. This causes: Jan 27, 2003 Remove CVS Id line to test GitHub push Oct 30, 2013 Revert "* Work around unit test problem caused by UTF-8." May 2, 2016



                           I N T E R C H A N G E

Interchange 5.10.0

Copyright (C) 2002-2016 Interchange Development Group
Copyright (C) 1996-2002 Red Hat, Inc.

Originally based on Vend 0.2 and 0.3, copyright 1995-96 by Andrew M. Wilcox.

This program is offered without warranty of any kind.
See file LICENSE for redistribution terms.


Interchange is a web application server, electronic catalog and database
display system. Features include:

  * online ordering
  * real-time credit card processing hooks
  * high-end database access and retrieval with SQL support
  * product categorizing, merchandising, and discounting
  * basic customer relationship management
  * dynamic content presentation
  * content management
  * internationalization and localization support
  * real-time tax and shipping hooks
  * reporting
  * possibility of web-based administration

Interchange requires Perl 5.8.5 or later, on a Unix-like operating system.

Interchange also requires some non-standard Perl modules to be installed on
your system. Unless you are installing from distribution-specific packages
(Red Hat, Debian, ...), the quick way to install the necessary support is to
run from the untarred Interchange directory:

  cpanm --installdeps .

Alternatively, you can run:

  perl -MCPAN -e 'install Bundle::Interchange'

If you would like to use a specific version of Perl, simply invoke
Perl with an absolute path to the Perl binary, such as

  /usr/local/bin/perl -MCPAN -e 'install Bundle::Interchange'


More information is in the following files and directories:

The text of the GNU General Public License (GPL), under which the Interchange
software is distributed.

Notes on using Interchange when installed from RPM packages.

Notes on using Interchange when installed from Debian packages.

How to access the Git repository to track ongoing development.

Changes per specified version family.

Instructions on how to upgrade from an earlier Interchange version.


Major files and directories in the distribution:

Makefile.PL    Script to create a Makefile, used for installation.
               (run ./configure for usage instructions)

dist/          The distribution files, exclusive of executable
               files and modules. Includes:

               interchange.cfg.dist   Distribution-default interchange.cfg
               strap/                 Demo catalog skeleton, used by makecat
               src/                   C and Perl code for CGI link programs
               lib/                   Back-end administrative interface
               code/                  Usertags and other customizable code       OS-specific configuration settings. None currently used.

eg/            Various helper scripts and addons.

lib/           The library modules needed to run Interchange.

scripts/       The executable files, relocated to bin/ in the install
               directory.    Script that adjusts paths in scripts/ for installation into
               bin/.        The installation test script.


                          I N S T A L L A T I O N

You can install Interchange as root for a multi-user system-wide setup, or
as an unprivileged user who will be the only one modifying Interchange files.

Here is the quick installation summary:

    tar xvzf interchange-5.10.0.tar.gz
    cd interchange-5.10.0
    perl Makefile.PL
    make test
    make install

If you would like to use a specific version of Perl, simply invoke
perl with an absolute path to the Perl binary, such as

    /usr/local/bin/perl Makefile.PL

The build procedure asks where you'd like to install Interchange and
the name of the user account that will own the installation.

The Interchange server doesn't do much if it isn't servicing one or more
actual catalogs, so you next need to make your first Interchange catalog,
as described in the next section.


                                 D E M O

There is a demo catalog skeleton (called 'strap') included.

To build your own catalog from the demo, go to the directory where you
installed Interchange (default is "interchange" in your home directory,
/usr/local/interchange for root installations, or /usr/lib/interchange
for RPM installations) and run:


Follow the prompts and after restarting the Interchange server you
should be able to access the new instance of the demo catalog.

Please note that some functionality (notably the reporting features)
may not be available if you are not using an SQL database such as
MySQL or PostgreSQL.

Visit to try out a live demo.


                         D O C U M E N T A T I O N

A documentation package is available, with documentation in many different
formats. This and other information is available at the Interchange home on
the web:


                         C O M P A T I B I L I T Y

Interchange is regularly tested on various Linux distributions and FreeBSD.
It has also been used on Mac OS X, Solaris, OpenBSD, Digital UNIX/Tru64, SCO,
AIX, and other Unix variants. It should work on any Unix with sufficiently
high Perl version number and the necessary Perl modules.