Help:Technical FAQ
From ZenMagick Wiki
Contents |
System Requirements
ZenMagick runs on top of zen-cart and has no extra requirements. Therefore, the standard zen-cart system requirements apply.
In particular the following software is required/supported:
- MySQL 4 or higher
- PHP5.2.x; NOTE: As of February 2008 PHP4 will no longer be supported.
- To use ZenMagick pretty links or Ultimate SEO[2|3], Apache httpd is required with mod_rewrite enabled
zen-cart mod compatibility
zen-cart mods can be classified into three major groups:
- admin mods
- These come generally in two flavours - modules and other admin tools.
- Since there is not a lot of customization done to the admin code those should all work as expected. There are reports for a number of admin mods that do work with various ZenMagick version.
- template mods
- Due to the fact that ZenMagick uses its own templating/theme code those mods are usually not compatible. Usually, they rely on zen-cart's file hierachy which makes them useless in the context of a ZenMagick theme.
- custom/new storefront functionality
- This is the grey area. Some do work - Google Sitemap is a good example. Siome need manual coding to apply the template changes to ZenMagick theme files. Others, again, do work in combination with ZenMagick plugins or are actually (re-)implemented as plugin. It's always worth asking about specific mods. If they provide to be popular there is a good chance that there is support or can be offered at short notice.
Troubleshooting
Enable displaying errors
The most effective way to find out more about template/coding errors is to add the following line to your local.php file. (Create the file in your zenmagick folder if it doesn’t exist)
<?php @ini_set("display_errors", true); ?>
This tells PHP to display all (fatal) error messages in the browser. Usually this is enough to give you a good idea as to what is wrong with the installation or template.
ZenMagick comes with a sample named local.in.php that contains (commented out) settings and commands that can be useful to get ZenMagick configured and logging set up so you’ll be able to read the logs even in a hosted environment where there is usually no (direct) access to the webserver’s logfiles.
Missing CSS and/or images
If everything seems to work fine but the site is missing all CSS and images, the most likely culprit are the .htaccess files that come with ZenMagick. It appears that they are not compatible with all httpd configurations.
The reason for those files it to restrict access as much as possible. However, it is considered safe to remove them without compromising security.
Page Not Found displayed for various pages
ZenMagick implements a number of new pages, most notably static pages (the equivalent of define pages). After a default zen-cart install, browsing those pages will result in Page Not Found, because zen-cart will check for physical files to handle those URLs.
Since those files do only exist as ZenMagick template files, zen-cart will return the Page Not Found page.
To avoid this, the option Missing Page Check under Configuration -> My Store needs to be set to Off.
