Installation, Upgrade, Uninstall & Release Notes

We have choosen the manual approach for installation of this Magento Extension, to give everyone also the freedom to look inside of the package before installation. Also if the extensions is active in a production environment, any automated update may interfere with the store functionality.

• Magento 1.6.x or above and all prerequisites coming with it.
• Your Magento installation is required to be faultless and fully functional.
• We strongly recommend to perform the first install on a non-productive system, to perform your settings and any customizations there first. And then to install the extension on your production system with transfering your settings and customization.
  
  

1. Take your Magento Shop offline in case you are installing on your Production System. In case during installation your Magento Store is activated the extensions installation may become incomplete and error messages or malfunctions may result.
   
   
2. Unpack the contents of the package and copy the content into the home directory of your Magento installation on your server:
   The Installation Package contains a directory structure that already holdes the individual files correct positions, and that is relative to the Magento Store's home directory (or installation path) on your server.
   If your Magento Store is installed in /home/www/magento then your home directory is to show a app subdirectory (as in the installation package).
   Extract the content of the Archive (or upload its content) into the home directory of your Magento Store, the head subdirectories of the Installation Package shall match the subdirectory structure of the home directory (as a check).
   
   
3. If you are using Caching in your Magento Store, login into your Magento Administration and refresh your Cache: System » Cache Management » All Cache » Refresh.
4. Read through here for the initial configuration of your Magento Store to work with EuVat.

Related Links

• The Magento Directory Structure

1. Take your Magento Shop offline in case you are upgrading your Production System. In case during upgrade your Magento Store is activated the extension upgrade may become incomplete and error messages or malfunctions may result.
   
   
2. Backup your Magento installation, or at least backup the folder app/code/local/Pisc/Agecheck for saving any current installed version of AgeCheck.
3. Delete the folder app/code/local/Pisc/Agecheck to ensure correct updating of store resources required by the extension.
4. Unpack the contents of the package and upload the content into the home directory of your Magento installation on your server.
5. Alternatively you may just unpack the files in app/code/local/Pisc/AgeCheck and app/etc/modules for the main extension files, and update any template related files later manually.
6. If you are using Caching in your Magento Store, login into your Magento Administration and refresh your Cache: System » Cache Management » All Cache » Refresh.

In case our Technical Team recommends to “Reinstall” the extension perform as followed, or when during the original installation (or a update) on your store some particular installation step did not fully apply to your store installation:

1. You may want to take your Store offline, be aware that removing the extension from a Store in operation may generate errors.
2. Disable your Stores Cache using the Administrator and System » Cache Management » All Cache » Disable
3. Logoff from the Administrator Backend of your Magento Store.
4. Open your Magento Database using a MySQL Database Frontend (like PhpMyAdmin) and remove the Version entry for AgeCheck in the Magento Database by opening the table core_resource and removing the row entry for agecheck_setup.
   This table name may carry the table prefix defined for your Magento installation.
5. Logon to the Administrator Backend of your Magento Store.
6. Enable or Update your Stores Cache using the Administrator and System » Cache Management » All Cache » Enable or Refresh

Uninstallation of AgeCheck is not recommended, as the Customer Data Model is being extended by additional Customer Attributes for storing verification data, and the these attributes relate to models of the extension.

Instead of it deactivate the complete extension:

1. Locate and open the Pisc_Agecheck.xml file in app/etc/modules with an editor.
2. Deactivate the extension by setting <active>true</active> to <active>false</active>.
3. At any later point in time you may reactivate the extension by setting <active>false</active> back to <active>true</active>.

In the rare event that Magento was unable to create the Database Tables for EuVat by the automated setup itself, here are the SQL Commands to create the EuVat Database Tables manually.

CREATE TABLE IF NOT EXISTS 'agecheck_verification_cache' (
  `cache_id`INT(11) NOT NULL AUTO_INCREMENT,
  `customer_id` INT(11) NOT NULL,
  `verification_data` text,
  `notification_data` text,
  `last_check` datetime,
  `response` VARCHAR(255) NULL,
  `last_response` datetime,
  `referer` VARCHAR(255) NULL,
  PRIMARY KEY (`cache_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='AgeCheck - Cache Table for verification queries';