HostMonster Web Hosting Help

Agora Shopping Cart Installation and Configuration

Problem:

How do I Install and Configure the Agora Shopping Cart?

Solution:

Please follow the below steps to ensure that your cart is properly setup and configured.

---------------------------------------------------------------------

Installing Agora From the 'Agora Cart Setup' icon within your account control panel:

  1. Set the administrator's username and password.
     
  2. Type in a store_name in the third text box.
     
  3. Click the 'Install' button.

---------------------------------------------------------------------

Logging Into the Store Manager

  1. In the new window that appears, click on the name of the shopping cart that you just created underneath the words 'Modify an existing Cart'.
     
  2. You'll be prompted to type in your username and password. Type in the username and password that you set in the previous step.
     
  3. Again you will be prompted for your username and password. Again, type in the username and password that you set in the previous step. (You may want to bookmark this page as it is your shopping cart's administrative area.)

---------------------------------------------------------------------

Getting To The Main Agora Settings Page After logging into the Store Manager:

  1. Click the 'Program Settings' link.
     
  2. Click the 'Main Agora Store Settings' button to go to the 'Main Agora Store Settings Page'.

---------------------------------------------------------------------

The Main Agora Settings Page

The 'Main Agora Store Settings Page' will have most of the values set for you. You only need to change the three below.

  1. Please select your Primary Payment Gateway:

    Here you choose how you'd like to process your orders. From the pulldown menu select Offline, AuthorizeNet, IntelliPay, iTransact, or LinkpointHTML.

    Offline means that you'd like to have your orders logged and you will process them offline through your own credit card software. The order is logged to a text file on the server and also e-mailed to the merchant. For security, the text file on the server will contain the type of credit card that is being used and the first eight digits of the credit card number. The e-mailed copy of the order that is sent to the merchant will contain the last eight digits of the credit card number, and the expiration date.

    Important: The location of the text file where half of the payment information is logged is as follows: public_html/<store_name>/log_files/your_order.log

    In other words, when you FTP to your account go to your public_html directory, then the <store_name> directory, and then the log_files directory. There you should see a file named 'your_order.log', which can be downloaded and viewed.

    Note: In the examples above replace <store_name> with your store's name (see Step 2 of the 'Installing Agora' section).

    Again, the other half of the payment information is mailed to you.

    While it is a housekeeping chore to collate these two files to obtain the full credit card information, it is also more secure. Many people have problems setting up PGP encryption on their server, so this seemed to be a resonable alternative. Plus, PGP technically needs to be purchased for commercial use.

    For real time credit card processing, Agora.cgi 4.0 currently allows you to use choose from AuthorizeNet, IntelliPay, iTransact, or LinkpointHTML.

    If you wish to use one of these options you must first set up a merchant account through one of the links below:

    AuthorizeNet http://www.authorizenet.com
    IntelliPay http://www.intellipay.com
    iTransact http://www.itransact.com
    LinkpointHTML http://www.linkpoint.com

  2. Do you wish to have orders e-mailed to you?

    Put a valid email address in this box. This is the email address that payment information is sent to. Note: If you use the email address that's already in the text box, remove the 'www' from the address.

  3. Enter the email address of your webmaster or administrator here:

    Put a valid email address in the box. This is the email address that appears as the return address when the customer is sent an order confirmation email.

    A customer service email address is a good choice for this. Note: If you use the email address that's already in the text box, remove the 'www' from the address.

Once you have entered all of the data above, click the 'Submit' button.

---------------------------------------------------------------------

Gateway Settings:

  • You should see a message stating, 'System settings have been successfully updated. Check your Gateway Settings here.'
     
  • Click the 'Gateway Settings' link.
     
  • Depending upon how you've decided to process orders, you will be required to enter gateway settings. Below are the different processing options along with their corresponding settings.

Offline Processing:

If you've chosen to process your orders offline, you will only be asked to enter one more piece of data.

  1. Please enter the Secure URL to your agora.cgi store.

    Enter the Secure URL below. Replace <account_username> with your account's username. Replace with your store's name (see Step 2 of the 'Installing Agora' section).

    (Example) https://yourdomainname.com/<store_name>/agora.cgi

    Note: Your account username can be found in the Account Setup Confirmation Email that was sent to you when your account was initially setup. If you did not receive the Account Setup Confirmation Email please contact us via phone at (866) 573-4678 or Live Chat and we will send it to the email address that you used when you signed up.

AuthorizeNet Processing:

  • Please contact AuthorizeNet for the values to use for your gateway settings (http://www.authorizenet.com). The instructions below should help as well. If you've chosen to use AuthorizeNet, you'll be asked to enter some additional information. Most of it is self explanatory, and will be used to customize the AuthorizeNet orderform. It is no longer necessary for you to have a secure server on your end to use Agora.cgi with AuthorizeNet. All order data is now collected on the AuthorizeNet secure server.
  1. 'Gateway Username'

    Enter a valid username provided to you by AuthorizeNet

  2. 'Secure URL to your Gateway's server'

    This is most likely:

    https://secure.authorize.net/gateway/transact.dll

  3. 'Complete URL to the logo you'd like to display on your orderform.'

    This MUST be a secure https URL. You can also leave this blank if you prefer.

    Enter the Secure URL below. Replace <account_username> with your account's username. Replace <store_name> with your store's name (see Step 2 of the 'Installing Agora' section). Replace <image_name.gif> with the name of an image file that you uploaded to your images directory with FTP.

    https://yourdomainname.com/<store_name>/html/images/<image_name.gif>

    Note: Your account username can be found in the Account Setup Confirmation Email that was sent to you when your account was initially setup. If you did not receive the Account Setup Confirmation Email please contact us via phone at (866) 573-4678 or Live Chat and we will send it to the email address that you used when you signed up.

  4. 'Background color of your orderform.'
     
  5. 'Text Color'
     
  6. 'Link Color' The three settings above are all self explanatory customization variables....
     
  7. 'Enter the text that you'd like displayed at the top of your orderform.'
     
  8. 'Enter the text that you'd like displayed at the bottom of your orderform.'

    Self explanatory....

  9. 'Enter the text that you'd like displayed at the top of your receipt page.'
     
  10. 'Enter the text that you'd like displayed at the bottom of your receipt page.'

    Self explanatory...

  11. 'Enter the text that you'd like displayed at the top of your customer's e-mail receipt.'
     
  12. 'Enter the text that you'd like displayed at the bottom of your customer's e-mail receipt.'

    The e-mail receipt is sent to the customer by AuthorizeNet after the order is processed.

iTransact Processing:

  • Please contact iTransact for the values to use for your gateway settings (http://www.itransact.com). The instructions below should help as well.
     
  • If you've chosen to use iTransact, you'll be asked to enter some additional information. Most of it is self explanatory, and will be used to customize the iTransact orderform. It is no longer necessary for you to have a secure server on your end to use Agora.cgi with iTransact. All order data is now collected on the iTransact secure server...
  1. 'Gateway Username'

    Enter a valid username provided to you by iTransact

  2. 'Secure URL to your Gateway's server'

    This is most likely: https://secure.itransact.com/cgi-bin/mas/split.cgi

  3. 'Enter the name of your business here.'

    Self explanatory

  4. 'Are setup to accept credit cards through iTransact'

    Select '0' for no, '1' for yes.'

  5. 'Are you setup to accept checks through iTransact'

    Select '0' for no, '1' for yes.'

  6. 'Are you setup to accept EFT through iTransact'

    Select '0' for no, '1' for yes.'

    These three variables need to be answered correctly for your specific account. If you are unsure of any of these, contact iTransact support for assistance.

  7. 'Do you want to allow customers to enter an alternate shipping address'

    Select '0' for no, '1' for yes.'

    If you answer yes to this, the iTransact orderform will allow customers to enter a shipping address that is different from the billing address. Depending on your business, you may or may not want to allow this.

  8. 'Enter the text that you'd like to appear in the body of the confirmation e-mail sent to the customer.'

    This is the e-mail that is sent to the customer by iTransact after the order is processed.

Linkpoint Processing:

  • Please contact Linkpoint for the values to use for your gateway settings (http://www.linkpoint.com).

IntelliPay Processing:

  • Please contact IntelliPay for the values to use for your gateway settings (http://www.intellipay.com).

---------------------------------------------------------------------

Linking To The Store From Your Website:

  • At this point you've setup a working store that can be accessed by going to:

    http://www.<yourdomain.com>/<store_name>/agora.cgi

  • To link to the store from any of your Web pages, put the following in your html: /<store_name>/agora.cgi>Go To My Store
     
  • Note: In the examples above replace <yourdomain.com> with your account domain name. Be sure to put the 'www' before your domain name. Also, replace <store_name> with your store's name (see Step 2 of the 'Installing Agora' section).
     
  • When you go to the links above you'll see some example categories and products that need to be replaced with your own categories and products. The following sections show you how to customize your store with your own categories and products.

---------------------------------------------------------------------

Adding To, Deleting From, and Editing Your Product Offering

  • Adding, deleting, and editing products is fairly intuitive and can be done by accessing the corresponding buttons from within your Store Manager. Instructions for logging into the Store Manager were provided in the 'Logging Into the Store Manager' section above.

---------------------------------------------------------------------

Using GPG To Send Encrypted Data Over Email (Advanced and Optional)

  • Although the method of sending half of the order information to your email account and retrieving the other half from your account via FTP should be enough security for most, the ability to use GPG (Gnu Privacy Guard) is supported by your account and the store software that you've just installed.
     
  • If you wish to send customer order data using GPG, you must have the ability to generate a key pair on your local machine. Once you've generated the key pair, you may add the ascii-armored public_key to the keyring via the Store Manager. Below are the steps for setting up your store to encrypt form data via GPG. Note: Using this method all of the order data is sent to you via email.
  1. Create a directory on your local computer as follows: C:\gnupg
     
  2. Download GPG from http://www.pgpi.org/download/gnupg/ and unzip/extract
     
  3. GPG and it's associated files to your C:\gnupg directory.
     
  4. Generate a key pair for yourself i.e. generate a private_key and a
     
  5. public_key on your local machine for the person that the order data will be sent to. To start the interactive key generation session type 'gpg '-gen-key' from a DOS command prompt while in your C:\gnupg directory.
     
  6. Below is what the GPG interactive key generation session will look like. Note: The GPG handbook describes this and everything else you need to know about GPG, and can be found at http://www.gnupg.org/gph/en/manual.html

    gpg '-gen-key

    Please select what kind of key you want: (1)DSA and ElGamal

    What keysize do you want' 768

    Please specify how long the key should be valid. 0

    Key does not expire at all' Is this correct' y

    Real name: Jon Doe

    Email address: emailaddress@domain.com (type the email address that your orders are being sent to)

    Comment:

    Change (N)ame,(C)omment,(E)mail, or (O)kay/(Q)uit' O

    You need a Passphrase to protect your secret key. XXXXXXXXXXXXXXXXXXX (type a Passphrase here and remember it because you'll need it to decrypt order data)

    Public and secret key created and signed.

  7. To confirm that the key pair that you just created was added type 'gpg '-list-keys' from the DOS command prompt while in your C:\gnupg directory as follows:

    gpg --list-keys

    c:/gnupg/pubring.gpg

    ---------------------------------------

    pub 1024D/BB7576AC 1999-06-04 Jon Doe emailaddress@domain.com

    sub 1024g/78E9A8FA 1999-06-04

  8. Output the public key that you just created to a text file as follows: Note: In the example below, the output text file is named 'support.gpg'. Additionally, in the example below replace 'emailaddress@domain.com' with the email address of the person to whom your order data is going to be sent to.

    gpg --output support.gpg --armor --export emailaddress@domain.com

  9. Open the text file that contains the public key in a text editor such as Notepad. The example above would have ouput the public key data to a file located at C:\gnupgsupport.gpg
     
  10. Highlight and copy the file contents. Below is an example of what a public key looks like. When highlighting and copying the file contents be sure to copy the whole thing including the '-----BEGIN' line and the '-----END' line.

    -----BEGIN PGP PUBLIC KEY BLOCK-----
    Version: GnuPG v1.0.6 (MingW32)
    Comment: For info see http://www.gnupg.org

    mQGiBDyo4FMRBAC2nUH+HZwg0SG2qjMDBQcSwjWG5aktJ3KTbO1OWsZPkvABmcaq
    h/jDlilyHJqh5Ai1NMY0WibjFVdZ3gXdGIoYjEEg6XFUoHXO4Ao3DMbquM1k7PQW
    KDXZ8hnOUk9CumfoTDadLLbzkBN2KW2ET/5+ryUuokn0hXoj0TRfV8U0mwCg0vt7
    GuCotp6BzmWyIR3yaG1+Eo0EAKO3IgSp8lkoJkDAi//dktZXeRxIex8uUCuvccoq
    MbETI5tbS0mH9ke4BT2F0UYy/6qRoakRnij7qB/IVlrHbHZzrnTMAy6EcJFmd9TJ
    CC63jHWXn+KDG5kvIOkUWJLxIuN8CYUr8wjZIY6Pmp9M98s7b+gL3fQz0ZuRr/CK
    OAegA/9/H1ZrOHNy0EGayXD13QisF6L0vpCEsq4N4aMsLzIU4GrjqpWqumJkHc8X
    CXaxFHPTg2gB1Mk1Lrbpd/WV7ym3sEIp4cNGW7i8KTEsJEjO7NVV5/qSbYYcp1kl
    YrDAayGCegtojm9hdPDrc46itCy8gxpkYsA4agl4cGH2nyHcq7QhU2VhbiBDb3J6
    byA8c2NvcnpvQGlwb3dlcndlYi5jb20+iFcEExECABcFAjyo4FMFCwcKAwQDFQMC
    AxYCAQIXgAAKCRAJzalal/SyhjfOAJ0ZAlYtH7Ph3msinxKqFg+wi2bvrgCgri6G
    0PukGBt4phhRRAWG5ppAQYG4zQQ8qOBUEAMA5wBOTjg1xiprTvvocgOKrCxzl4re
    RQxAqiwL5MhOugNuHkx4880tJpd+K5ZUTWeFj/myN/6LJcXODnhz2kbe5atxZiKB
    0W5k7A1tFk9QdmELQwe2hEwE43JvdlZ7MmCnAAMHAv9oJJiG7KFo8vl/kdmBgAiv
    d3TQ57QpAbdyey05mnr7ajJ4zBAym1vp0B6ft75U2mZL6Gc/YeMxQJ5c9T0oHWgU
    llAGwusIyg2CV4uuuDFqFkkc+GHdrz0Fy4Hu7gPBHGKIRgQYEQIABgUCPKjgVAAK
    CRAJzalal/Syhq3yAJsGT+My+qAmU3+pZe1q1w5OjSgSdwCeLmL+rd9i8TXQeM/2
    ElgECYxZMKs=
    =2bYz
    -----END PGP PUBLIC KEY BLOCK----

  11. From your Store Manager

    i.e. http://<yourdomain.com>/<store_name>/protected/manager.cgi click on the GnuPG/PGP link at the top. Note: In the path above, replace <yourdomain.com> with your account domain name and replace <store_name> with your store's name.

  12. Fill out the settings as specified in the following steps (Note: leave the settings as they are unless specified otherwise).

    Do you wish to have orders encrypted in the log file and email' Select 'Yes'

    Please choose how to encrypt and/or verify orders on your host server: Select 'GPG'

    Path to GPG: /usr/bin/gpg

    E-mail address to use to lookup an encryption key on the keyring: Use the email address that you used to generate the key pair. Note: This should be the same address that you opted to have order data sent to.

    Convert Newlines to anything Leave Alone

    Paste an "ascii-armored" public key to add to the keyring here: Here is where you paste the public_key that you generated in step 2 above. Note: There is no need to join the newlines at the end of each line i.e. just copy and paste the public key and don't alter it in any way.

    Hit 'Submit'

---------------------------------------------------------------------

Congratulations! Now when order data is sent to you, you will receive it in a GPG encrypted format. To decrypt the data that is sent to you:

  1. Copy the contents of the email that you receive to a text file, and when you save it, give it a '.gpg' file extension. For this example we'll name the file 'order1.gpg'.
     
  2. Put the 'order1.gpg' file in your C:\gnupg directory.
     
  3. From a DOS prompt while in the gnupg directory type the following:

    gpg --output order1.txt --decrypt order1.gpg

  4. Open order1.txt in a text editor to view the order data in a human readable format.

 

Knowledgebase Article 155,123 views bookmark tags: agora cart shopping (updated 93 days ago)


Was this resource helpful?

Did this resolve your issue?


Please add any other comments or suggestions about this content:





Recommended Help Content

What payment gateways are supported by the Agora Shopping Cart? (updated 2109 days ago)
Knowledgebase Article 91,574 views tags: agora cart shopping

Images in the Agora shopping cart not showing or showing broken link images. (updated 2123 days ago)
Knowledgebase Article 90,852 views tags: agora cart images

When I try to log into my OSCommerce shopping cart using https://secure.HostMonster.com/~username url, my shopping cart isn't the same. It is as though I have 2 carts, one for HTTP (unsecure) an (updated 2131 days ago)
Knowledgebase Article 58,122 views tags: ssl

Related Help Content

HostMonster offers numerous email options. (updated 571 days ago)
Knowledgebase Article 137,704 views tags: basic configuration configure email mail setup

An overview of what shopping carts are available and why you would want to use one. (updated 753 days ago)
Knowledgebase Article 18,958 views tags:

We provide a program which makes it very easy to install third party scripts to your hosting account. If you want your website to have a WordPress blog, you can use MOJO Marketplace to install WordPres (updated 118 days ago)
Getting Started Article 550,959 views tags: blog install scripts simple wordpress

This article explains how to install WordPress when Mojo is unable to create the database automatically. (updated 19 days ago)
Knowledgebase Article 3,569 views tags: MOJO automatic database install wordpress

How do I install my own Ruby Gems? (updated 629 days ago)
Knowledgebase Article 90,065 views tags: gem install ruby

Configuring your email client: Outlook Express. (updated 660 days ago)
Knowledgebase Article 248,195 views tags: configuration configure email express imap outlook pop setup

To install a phpBB forum using MOJO Marketplace, log into the cPanel and scroll down to the Software/Services category. Click on the MOJO Marketplace icon. Click on the phpBB icon. Click the Install Now bu (updated 725 days ago)
Getting Started Article 182,861 views tags: MOJO checkbox install phpbb terms

Install Themes These steps will help you install and select a WordPress theme for your blog. Inside the WordPress Dashboard, select the Add New Themes link in the Appearance Menu. You can search for (updated 124 days ago)
Getting Started Article 262,064 views tags: install link theme themes wordpress