
Versions: 1.052 (v4.4.x) & 1.1 (v4.5.x)
Updated: April 27th 2012
Demo (v4.4.5) | Demo (v4.5.0) | X-Cart Forum Thread | Support | Purchase
Ability is an advanced, all-purpose X-Cart v4.4.x / v4.5.x template solution, with a rich amount of layout possibilities and features built-in.
The idea behind Ability is to give you all the design flexibility and features you need, in one template, whilst keeping your costs down.
It can be used as the foundation to any web store. You'll be surprised at what you can achieve with this template alone.
The template uses modern javascript and CSS techniques and is therefore aimed at modern browsers.
It has been tested with: Firefox 8-12 / Chrome 11 / Opera 11 / Safari 5 for Windows / Internet Explorer 6*/7**/8/9
It should also work with capable, modern mobile devices such as iPad etc.
* IE6 is nearing it's end of life and strictly not supported by us. You should encourage any IE6 users to upgrade.
** IE7 is an old browser, some features of the template may not work 100% correctly. You should also encourage any IE7 users to upgrade.
Microsoft will soon be silently updating old IE browser users to at least IE8.
In the meantime, there is an Ability option to redirect IE6/7 users to a browser upgrade page.
If / when we update the template and you require the updated files, just contact us with your order ID + X-Cart version and we'll send them to you promptly.
If you are happy with your purchase, please vote and post a brief review here. Thank you!
If you intend to rate us less than 5 stars, please get in touch us with us first, so that we can assist with any issues you may be experiencing.
(a) In admin go to Tools > Patch/Upgrade, underneath Apply SQL patch, browse to the SQL patch file, patch/patch_install.sql and click 'Apply'.
If for any reason you need to uninstall the template, use patch_uninstall.sql.
(b) The Ability statistics addon requires a database to store traffic data. It adds six new database tables.
You can use your X-Cart database to store the data, or you can use an alternative database.
If using the X-Cart database, in admin go to Tools > Patch/Upgrade, underneath Apply SQL patch, browse to the SQL patch file, patch/addons/patch_statistics_addon_install.sql and click 'Apply'.
If you are using an alternative database, patch the database using a tool like PHPMyAdmin or similar.
If for any reason you need to uninstall the statistics addon, use patch/addons/patch_statistics_addon_uninstall.sql.
(a) Upload all files in the upload directory to your store root directory.
(b) Upload the graphics files as mentioned in your order email.
(a) In cart.php
After...
Insert...
(b) In home.php
After...
Insert...
(c) In product.php
Before...
Insert...
(d) In products.php
Before...
Insert...
(e) In recommends.php
Before...
Insert...
(f) In search.php
Before...
Insert...
(g) In modules/Bestsellers/bestsellers.php
Before...
Insert...
(h) In modules/Upselling_Products/related_products.php
Before...
Insert...
(i) In skin/common_files/common_templates.tpl
Before...
Insert...
(j) X-Cart Gold users, in skin/common_files/single/home.tpl
X-Cart Pro users, In skin/common_files/admin/home.tpl
Before...
Insert...
(k) X-Cart Gold users, in skin/common_files/single/menu_box.tpl
X-Cart Pro users, In skin/common_files/admin/menu_box.tpl
After...
Insert...
(l) In include/search.php
After...
Insert...
» Advanced Minicart Modifications
(m) In include/common.php
After...
Insert...
(n) In skin/common_files/js/ajax.minicart.js
Replace...
With...
» Mega Dropdown Menu Modifications
(o) In admin/process_category.php
After...
Insert...
(p) In include/func/func.category.php
After...
Insert...
» Statistics Addon Modifications
(q) In admin/ability_stats_config.php
Update the database settings...
If you are using the X-Cart database to store statistical data, you can obtain the settings from config.php
In admin go to Modules and enable the Flyout Menus module.
Then to the right of Flyout Menus, click the Configure link.
Uncheck the Cache the menu option and click Apply changes.
In admin go to Settings > General Settings > Appearance, from the skin options, select Ability Template and click 'Apply changes'.
In Tools > Maintenance click the 'Clear templates/X-Cart cache' button (IMPORTANT)
Template installation complete!
The template should now be active and you should be able to view the template settings, via the admin 'Settings' menu tab.
PLEASE NOTE! If the template is not appearing as per the demo, and / or you cannot see the template settings link in admin, then the most likely cause will be that the SQL patch has not been applied correctly. Re-apply the install patch (step 1), then clear the template cache.
(a) In General Settings > Company, update your Company name and URL (ensure you have http:// in front of your URL).
(b) In General Settings, enable 'Parse Smarty tags in the content of embedded static pages'.
(c) Create a newsletter in Admin > Content > News Management, then create one news message.
(d) Add the following code to your root .htaccess file (required for the X-Cart JS/CSS speedup tools) ...
(e) If using X-Cart Clean URLs, add the relevant .htaccess code in General Settings > SEO.
(f) Ensure rss_news.xml and rss_products.xml in the store root folder are writable (CHMOD 777).
(g) Should you wish to start collecting traffic data, in the Ability settings, enable the Traffic statistics gatherer / visitor counter addon.
In X-Cart v4.3.x and below, you had to modify the entire skin1 folder to design your skin.
In X-Cart v4.4.x onwards they introduced a new way of creating skins.
Now, the main template repository is skin/common_files
Any files in skin/ability, will override those in /skin/common_files
The Smarty variable that displays the path to the main template repository is {$SkinDir}
The Smarty variable that displays the path to the Ability template is {$AltSkinDir}
The main stylesheet for editing much of the skin styling is - skin/ability/custom/css/common.css
The stylesheets for each of the preset / custom themes reside in - skin/ability/custom/css/themes
Click here for example theme CSS with comments.
You can choose a different header / footer in the Ability settings.
Headers reside in - skin/ability/custom/header
Footers reside in - skin/ability/custom/footer
Header logo images reside in - skin/ability/custom/images/logos
Four sizes are available, which you can choose in the Ability settings.
You can also choose a textual logo, which uses Google fonts. You can choose the text and fonts in the Ability settings.
Much of the homepage promotions can be enabled/disabled from the Ability template settings.
The main template for re-ordering homepage promotions is - skin/ability/customer/main/welcome.tpl
The central folder for the homepage image sliders etc. is skin/ability/custom/welcome/promotions
Responsive image slider - skin/ability/custom/welcome/promotions/image_slider/image_slider.tpl
Camera image slider - skin/ability/custom/welcome/promotions/camera_slider/camera_slider.tpl
3D flash image slider - skin/ability/custom/welcome/promotions/flash_slider/piecemaker_medium.xml - (or _small or _large depending on layout)
Featured image box - skin/ability/custom/welcome/promotions/featured_box/featured_box_medium.tpl - (or _small or _large depending on layout)
Horizontal image roundabout - skin/ability/custom/welcome/promotions/image_roundabout/image_roundabout.tpl
Horizontal image accordion - skin/ability/custom/welcome/promotions/accordion/accordion.tpl
Static image - skin/ability/custom/welcome/promotions/static_image - (image filename and link can be set in Ability settings)
YouTube video - skin/ability/custom/welcome/promotions/video - (video ID can be set in Ability settings)
In admin > languages search for and edit - lbl_txt_welcome
Countdown date and hyperlink to either product or category can be set in Ability settings.
It will automatically display either a product image or category icon.
You can set the countdown message and countdown expired text in Ability settings.
5 level animated dropdown/flyout menu - skin/ability/custom/addons/menus/horiz/dropdown/css/dropdown.css
Or for quick colour customisation, in skin/ability/custom/addons/menus/menus_common.tpl - uncomment line 14 and set the colours...
3 level mega dropdown menu - skin/ability/custom/addons/menus/horiz/mega/css/mega.css
1 level tabbed category menu - skin/ability/custom/css/common.css (look for SPEEDBAR TABS)
Tabbed speedbar menu - skin/ability/custom/css/common.css (look for SPEEDBAR TABS)
Tabbed custom menu - skin/ability/custom/css/common.css (look for SPEEDBAR TABS)
You may wish to close your store while organising your categories.
If you have many sub-categories, it may take some time to re-organise the categories to achieve the desired overall effect.
Enable the mega dropdown menu in the Ability settings, then go into your admin categories section to manage your dropdown menus.
Change the order of your categories by adjusting the order 'Pos.' fields.
Three new fields appear on the right hand side... (these only appear at the root category level)
If categories are not displaying in the correct manner, go into Tools > Maintenance and click the button - Force cache generation
If for any reason you get an unusual category display, try setting the number of columns to a number divisable by the total subcategories.
Eg. If you have 9 subcategories, use 3 columns. If you have 24 subcategories, use 4 columns.
Also, avoid mixing 2nd level categories with 2nd / 3rd level categories, as it may affect the category layout.
The stylesheet to modify styles is - skin/ability/custom/addons/menus/horiz/mega/css/mega.css
5 level flyout menu - skin/ability/custom/addons/menus/vert/flyout/css/flyout.css
Or for quick colour customisation, in skin/ability/custom/addons/menus/menus_common.tpl - uncomment line 55 and set the colours...
3 level tree menu - skin/ability/custom/addons/menus/vert/tree/css/jquery.treeview.css
2 level sliding menu - skin/ability/custom/addons/menus/vert/sliding/css/sliding.css
Modify one or more of the following templates, depending on your chosen column layout...
2 columns with left hand menu - skin/ability/customer/left_right_bar_2_cols.tpl
2 columns with right hand menu - skin/ability/customer/left_right_bar_2_cols.tpl
3 columns with left/right menus - skin/ability/customer/left_bar.tpl AND skin/ability/customer/right_bar.tpl
We'll soon be adding some custom themes for free download, as well as some premium themes you can purchase.
v1.1 - Major Update
v1.052 - Minor Update
v1.051 - Minor Update
v1.04 - Minor Update
v1.03 - Minor Update
v1.02 - Minor Update
v1.01 - Minor Update
v1.0 - Initial Release