Enable PHP Error Reporting
Maian Cart is coded to not show PHP errors by default, but it can be a useful debugging tool if you are modifying any of the PHP templates and something isn`t working properly. OR if you encounter a white screen. Error reporting is set in the following files:
control/error-reporting.php
admin/control/error-reporting.php
E_ALL is generally recommended for debugging.
What does the following Ioncube loader error mean?
If you receive the following error.. The file "/home/server.../store/control/system/core/c2.php" cannot be decoded by this version of the ionCube Loader. If you are the administrator of this site then please install the latest version of the ionCube Loader. ..it means that your server is running v3 ioncube loaders. These are obsolete now. Min v4 loaders are required.
All I see is a white page. Why?
The loading of the software has failed and the error reporting on the server is set to not display errors. Check your error logs. If nothing is there you can try enabling error logging as specified above.
What files are encoded and cannot be changed?
Please see the ionCube section.
Can I have files load from the main index.php files even though they are encoded?
Yes, see the following files:
admin/control/index-parser.php
control/index-parser.php
How do I install ionCube?
For Maian Cart to run your server must be compiled with support for the ionCube loaders. Min v4 loaders are required. Your web hosting company will be able to help. If you run
your own server, see the ionCube section for help. ionCube is widely supported by default on most shared hosting servers.
Whilst the cart system can help secure your downloads from standard web link sharing, it cannot help prevent file sharing.
How Do I Secure Product Downloads?
Your "product-downloads" folder should be OUTSIDE of your web root. That is, in a location, not accessible in a web browser. This will prevent links from being shared. However, it won`t prevent people from sharing files. With standard email and the many cloud storage solutions, its impossible to prevent file sharing. Even DRM encoding is pointless these days as software can be purchased to remove the DRM encoding.
Can I change the "product-downloads" folder name?
Yes. Log into your admin area and go to "System > Global Cart Settings". See the downloads section.
Product Downloads are 0 Bytes. Is there a fix?
By default, Maian Cart flushes the output buffer for product downloads. If output buffering is disabled on your server you may find that product downloads are 0 bytes.
1. Firstly, check your paths and download file names are correct.
2. Disable the buffer flush in 'control/defined.inc.php'.
define('DOWNLOADS_FLUSH_BUFFER', 0);
Then re-try.
Can I include the product code/model number on the category pages?
Yes, open the 'content/*theme*/html/categories/category-product.htm' file and use the following where you want the code to appear: {pcode} It can also be used in the product description popup. Open 'content/*theme*/product-description.tpl.php' and use: <?php echo $this->TEXT[2]; ?> This is optional and not displayed by default.
When I print invoices and packing slips I see the title and url at the top of the pages, can I remove this?
Yes, this is a browser setting and not a script setting. If you are using Firefox, click the 'Print Preview' button and then the 'Margins & Header/Footer' tab. Set all header attributes to 'blank.
Can you install the ionCube loaders for me?
Possibly, but if root access is required this won`t be an option. Some servers allow a PHP.ini override. This will only be an option on Linux servers.
Will the system work with PHP6?
No, the system is not tested and encoded for PHP6.
Can I upgrade from a previous version older than v2.0?
Sorry, this isn`t possible. v2.0 has been re-coded from the ground up and is not the same as previous versions.
I`m using Paypal and the payments are failing. Any ideas?
Have you setup the IPN correctly? Also, have you set Paypal to apply a sales tax? If you have, your payments will fail. You should set up tax in the store.
404/400 etc Error messages are pretty bland. Can I create my own?
Yes, just edit the files in the following folder: control/system/headers/ These files are NOT encoded.
I need to execute some code after a successul payment. Is this possible?
Yes, see the notes in the "control/gateways/callback-custom.php" file.
Can I view any debug logs for payment routines?
Yes, see here.
Can I change the text in the software and add my own wording?
Yes, see the language section.
Can I change the width and height of YouTube videos in BB Code?
Yes, more info here.
Can I change the width and height of Vimeo videos in BB Code?
Yes, more info here.
Can I change the BB code mp3 player appearance?
Yes, more info here.
Can I change the BB code soundcloud player appearance?
Yes, more info here.
Can I load products on a single page without pagination?
Yes, but remember this may cause load issues on large database, especially for search results. Set your preferences in the 'control/defined.inc.php' file:
define('VIEW_ALL_CATEGORY_DD', 'no');
define('VIEW_ALL_BRANDS_DD', 'no');
define('VIEW_ALL_SPECIALS_DD', 'no');
define('VIEW_ALL_SEARCH_DD', 'no');
Set to 'yes' to enable.
Can I use TLS or SSL for mail security as required by Google/Amazon etc?
Yes, open the following file:
control/classes/mailer/class.phpmailer.php
On line 210, change the following variable:
public $SMTPSecure = '';
Can only be blank, tls or ssl.
public $SMTPSecure = '';
public $SMTPSecure = 'tls';
public $SMTPSecure = 'ssl';
Can I remove the website name from the e-mail subjects?
Yes, search the following 2 folders:
content/*theme*/language/english/
admin/templates/language/english/
You are looking for the following string:
[{website}]
Remove all instances of this string EXACTLY as you see it, so with brackets and braces.
Can I add custom admin header/footer code?
Yes, the admin area is fully editable, accept encoded files in the "admin/control/core/*" folder.
When I run the currency updater cron the output is a licence error. What can I do?
If you see the following error when running the cron..
"The following encoding error has occured while running this software: The 'licence.lic' file within this installation cannot run on this server. Licence file is encoded for a different domain."
..click here for help.
Can I remove the floating 'View Basket' image and link?
Yes, see the note in the following file: content/*theme*/footer.tpl.php
Can I edit the store footer link area?
You can alter the layout via the stylesheet, but you cannot adjust the structure. If you have the commercial version, simply edit: content/*theme*/html/footer-commercial.htm
Can I add links to the admin homepage quick links?
Yes, please click here for more information.
Can I remove the newsletter signup option?
Yes, just edit the 'content/*theme*/footer.tpl.php' file and remove the code.
I would like to add my own logo. Is this possible?
Yes of course, just overwrite the 'content/*theme*/images/logo.gif' with your own image. Or use the logo upload option in your admin area.
Can I edit the PHP files?
All unencrypted PHP files can be edited, which is 99% of them. Encrypted files must NOT be touched. More info here.
If you edit an encrypted file the system will fail.
Can I integrate the layout into my own site design?
Yes, you`ll need to edit all the template files in the 'content/*theme*/' folder. Click here for more help.
Can I disable MySQL errors for security?
Yes, edit the 'control/connect.inc.php' file. Set the 'ENABLE_MYSQL_ERRORS' value to 0.
You should also add a default message by editing 'MYSQL_DEFAULT_ERROR'.
Can I have HTML formatted e-mails?
Yes, edit the 'control/defined.inc.php' file. Change the value of 'ENABLE_HTML_IN_EMAILS' to 1.
Remember that you`ll need to reformat the e-mail templates and add HTML
line breaks or else the code will be on one line.
Can I NOT have sub categories auto open when viewing parents
Yes, edit the 'control/defined.inc.php' file. Change the value of 'AUTO_OPEN_SUB_MENUS' to 0.
Can the admin menu appear on mouseover instead of on click?
Yes, open the 'admin/templates/header.php' file and change:
trigger: 'click'
to:
trigger: 'mouseover'
Can I NOT show out of stock items in the cart?
Yes, log into your admin area and access "System > Global Cart Settings" and edit the '"Out of Stock" Product Handling' option.
Can I remove the Maian Cart links in e-mails?
Sorry, not in the free version. The commercial upgrade removes this option.
How much do I have to pay for upgrades?
Nothing at all. All future upgrades are FREE of charge, which is great value for money.
Ok, I`ve purchased a licence. What do I do now?
Firstly, go to the Maian Script World Licence Centre and log in with the username/password sent to you in the e-mail you received after purchase. If you
didn`t receive this e-mail, please contact me via the Maian Cart website.
Once you have logged in, use the options provided to generate your licence. Your new licence file will be included in a zip file along with a readme file. You should
replace the default .lic file with your new one. This will unlock the free feature restrictions.
I have some great suggestions to make the system better. Can I let you know?
Yes please. Use the support/contact option on the Maian Cart website.
Can you recommend a good web host?
There are lots of good web hosting companies around. Try a search on Google. Read what other people say. Remember that good support is paramount when looking for a good host, not cheap prices.
I would like to add Google Anayltics to all pages, is this possible?
Yes, see the note in the following file: content/*theme*/footer.tpl.php
In admin for "In Stock Overview" export, can I change the (P) & (A) prefixes?
Yes, open the 'admin/control/defined.inc.php' file and change the following:
define('IN_STOCK_PREFIX_PRODUCTS', '(P) ');
define('IN_STOCK_PREFIX_ATTRIBUTES', '(A) ');
Can I disable the "MP3 Previews" link on the product manage page in admin?
Yes, open the 'admin/control/defined.inc.php' file and find the following: define('PRODUCT_MANAGE_MP3', 1); Set to '0' to disable.
Can I use some fancy coding to hide your footer links?
This is against the scripts licence. Dishonesty is a bad trait.
Can I generate PDFs of the invoices and packing slips?
Yes. Easiest way is to install a PDF print server. When viewing the invoice or packing slip in your browser, select the print option and the PDF print server. There are some excellent free ones around, including Bullzip, doPDF, CutePDF, PDF Creator & PDF24 Creator. (Note that I am in no way affiliated with these programs and they are used at your own risk)
Can I have the newsletter opt in option on checkout checked by default?
Yes. Open the following template file in your text editor: content/*theme*/html/basket-checkout/basket-newsletter-opt-in.htm Apply 'checked' to checkbox: <input type="checkbox" name="newsletter_optin" value="yes" checked="checked" />
I have the Zip functions enabled, but I never see a download link. Why?
Two possible reasons. You have the threshold set to a low amount for the zip file size. Or at least one of your products is remotely located in which case the zip option is disabled. Only locally hosted files are supported at the moment.
Can I change the layout of the invoice and packing slips?
Yes, these are not encoded. Template files are located at:
admin/templates/windows/invoice.php
admin/templates/windows/packing-slip.php
Stylesheets are located at:
admin/templates/css/invoice.css
admin/templates/css/packing-slip.css
Can I NOT show disabled categories when adding/editing products?
Yes, see 'admin/control/defined.inc.php' and the following value: define('SHOW_DISABLED_CATS_ADD_PRODUCT', 1); Set to 0.
Can I NOT show the software version check link in the admin header?
Yes, see 'admin/control/defined.inc.php' and the following value: define('DISPLAY_SOFTWARE_VERSION_CHECK', 1); Set to 0.
Can I NOT have banners renamed?
Yes, see 'admin/control/defined.inc.php' and the following value: define('RENAME_BANNERS', 1); Set to 0.
Can I change the 'img_' prefix for banner uploads?
Yes, see 'admin/control/defined.inc.php' and the following value: define('BANNER_PREFIX', 'img_'); Set to your preferred prefix or leave blank for no prefix.
Can I have the option to save attachments to the server yes by default?
Yes, see 'admin/control/defined.inc.php' and the following value: define('SAVE_ATTACHMENTS_TO_SERVER', 'no'); Set to 'yes'.
Can I disable the slug auto suggestion?
Yes, see 'admin/control/defined.inc.php' and the following value: define('ENABLE_SLUG_SUGGESTION', 1); Set to 0.
Can I disable the cookie option on the admin login?
Yes, see 'admin/control/defined.inc.php' and the following value: define('ENABLE_LOGIN_COOKIE', 1); Set to 0.
Can I change the default admin homepage sales view to something other than today?
Yes, see 'admin/control/defined.inc.php' and the following value:
define('ADMIN_HOME_DEFAULT_SALES_VIEW', 'today');
Can be any of the following:
today = Today
week = This Week
month = This Month
year = This Year
Can I not have pictures renamed when adding product images?
Yes, access the following page in your admin area: SYSTEM > General Settings
Can I change default order by options in the system?
Yes, see 'control/defined.inc.php'.
Can I increase or decrease the size of the auto created thumbnails?
Yes, access the following page in your admin area: SYSTEM > General Settings