====== AcuInvoice Simple Store ======

===== Summary =====
The AcuInvoice Simple Store is a free e-commerce application written in PHP that uses the AcuInvoice API to enable AcuInvoice subscribers to quickly generate a standards-compliant web store.  Order information is passed securely via the AcuInvoice API to the subscriber’s account and invoices are automatically sent. If you sell digital goods (MP3s, images, software, etc), the items will be automatically delivered to the customer once payment is received and the invoice is converted into a closed state.  Since the application uses the AcuInvoice API, the AcuInvoice Simple Store automatically works with any AcuInvoice payment gateway, currently, PayPal, 2checkout.com, Amazon Flexible Payment Service, Google Checkout, or Authorize.net.

===== Quick Start =====
  - Create an AcuInvoice account at http://www.acuinvoice.com/
  - After confirming the account:
    -Update your account details
    -Set your account preferences, including the activation of one or more AcuInvoice-supported payment gateways.
    -Write down your AcuInvoice API key located in My Account | Preferences in your account.
  - Download the AcuInvoice Simple Store, unpack it and upload it to your web server
  - Create a MySQL database
  - Follow the configuration instructions as shown in the video toward the bottom of this page
  - Configure your AcuInvoice Simple Store from within the store's administrative interface
 



===== Version & Download =====
The AcuInvoice Simple Store is in version 1.0 and was released on 4 March, 2008.  Updates will be released as the AcuInvoice feature set is expanded.  {{simple-store-3-5-2008.zip|}}

===== Technical Requirements =====
  - An AcuInvoice account and API key
  - It is recommended that you have one or more supported AcuInvoice payment gateways enabled
  - PHP 5.0.0 or higher
  - MySQL extension loaded (in php.ini)
  - SimpleXML extension loaded (in php.ini)
  - This is not a requirement but a recommendation: allow_url_fopen = 1 (in php.ini). If this option is turned off (value 0) you will still have a fully operational store, however every downloadable item and product image should be uploaded to the store server via the admin application. Linking to remote files and images will not be possible.

===== Installing the AcuInvoice Simple Store =====
To install the AcuInvoice Simple Store, perform the following steps:
  - Unpack the archive in a web accessible directory of your choice.
  - For the following files and directories, set the usergroup to the same group that your web server process uses and set permissions to 775: logs/, uploads/, config.base.inc.php, main.css, container.css
  - Create a MySQL database for the store.
  - Run "install.php" from your browser and enter the required data.

Once the installation has completed successfully you can manage your product, store content, visual style, etc. through the administrative application "admin.php".

The customer part of the store is located at "index.php".  See also the installation video below.

{{youtube>large:QxkNv3go75s}} 

===== Setting Up the AcuInvoice Simple Store =====
{{youtube>large:qvtYpz-Jcg0}} 

==== Standalone Mode ====
Standalone mode is the store's default mode of operation.  This mode renders the store at /index.php in directory where you installed the store.

==== Embeddable Mode ====
To embed the store in an existing page (assuming the page is generated by a PHP script):
  - Select "Use embeddable mode" from the Settings page in the admin.
  - If you use inline PHP (mixed with the HTML of the page) you can display the store content by the following call:
	
		<?php echo include '/path/to/store/index.php'; ?>
Alternately, if you use some sort of template engine such as Smarty, you can do this:
	
		$smarty->assign('store_content', include '/path/to/store/index.php'; ?>
where 'store_content' is the name of the replacement tag in your HTML template.

===== Receiving Payment & Delivery of Digital Goods =====
{{youtube>large:NNs7YC--wXY}}