Documentation
Installation instructions
You can install extension using Extension Installer or manually. In the latter case unpack and upload all folders from "upload" directory to the root of your store. If there's install.xml file in the package, rename it to extension_name.ocmod.xml, replacing "extension_name" with extension's name (or any other name), and upload it to "system" folder. When upgrading from previous version simply rewrite all existing files. Refresh modifications cache from Extensions -> Modifications page (not needed if install.xml file is not included in the package).
Note for OpenCart 3 users
If you see "The directory is not allowed to be written to" error message, download OpenCart 3.0 Extension Installer Fix from this page and install it. Then install the main extension.
Note for OpenCart 2.0.X users
Sometimes OCMod inserts modification in multiple files, which are separated by "|" character in XML-file. On earlier OpenCart 2 versions a comma was used instead. To quickly fix this, open XML file (usually, install.xml) and replace all occurrences of "|" character with "," for "path" attribute in every applicable <file> element. Search for "<file path=" to quickly find and highlight all elements.
If after installation you have "Permission denied" issue when accessing Modules, Shipping, Payments, Order Totals (or any other) section of Extensions menu, remove "module", "shipping", "payment", "total" (or any other) folder from "admin/controller/extension" directory. Same for "admin/language/en-gb/extension" directory. For example ("module" should be removed from both paths):
admin/controller/extension/module
admin/language/en-gb/extension/module
Permissions
In some cases it is required to manually set permissions for installed extension. To do this go to System -> User Groups, find your group and select access/modify permissions for desired extension. You can find extension in permissions list by folder/filename pair (for example, marketing/acoupon).
Extension Setup
Go to Extensions -> Modules, find Smart SEO, click Install and then setup accordingly.
General Options
Smart SEO come with the set of basic SEO options, which you might want to setup first of all.
- Auto Fill - If you have multiple languages installed in your store, enable this option to automatically fill all the data from main language to other ones. This option works, when you save a catalog item (product, category etc).
- Add hreflang - Adds LINK tag with HREFLANG attribute to serve correct language or regional URL in search results. This option is useful, when you have multiple languages installed.
Custom Titles & Meta
If you want to create custom titles for your product, add a title to description or automatically create tags and meta, go to Titles & Meta tab and setup desired catalog items. Items can be customized with shortcodes: {name}, {description}, {category}, and any other field from corresponding database table. For example, if you want to add H2 tag to your product description, you can do the following:
<h2>{name}</h2>{description}
This will add product name in H2 tag to the beginning of description. Same way you can create tags for every product without entering them on product editing page:
{name}, {tag}, {category}
Possibilities are virtually limitless and even custom fields are supported. New data will be automatically generated on page load, original data remains untouched.
Automatic SEF URls
Instead of manually creating SEF URLs for every catalog item, you can set them to be generated automatically. "Product Name" will be turned into "product-name" and automatically transliterated, if necessary. You can add additional information to every URL (language prefix or custom suffix), limit number of characters in your URLs and more.
http://yoursite.com/en/category-name/product-name.html
In example above we've added language prefix (en) and suffix (.html). You can also define "page" and "tag" values for each language separately and create custom character replacement rules.
Transliteration & Filtering
If you have multiple languages installed in your store, you need to create valid SEF URLs for every language. Smart SEO can do this for you and transliterate item titles in any language to nice looking SEF URLs.
We've already added a few languages in the package. You will find them all here, in this folder:
admin/model/module/translit
You can add as many languages as you like, using language ISO code as file name. Or you can create custom "character-replacement" pairs, separated by comma, right in extension settings:
Custom Characters: č:c, š:s, ž:z
Additionally you can filter characters or whole words in URLs. For example, to remove common words like "and", "to", "more" etc.
Filter Words: and, more, to
This will turn "fork-and-spoon" into "fork-spoon" and make your URL more strict.
URL Aliases
By default OpenCart automatically creates URL aliases for most routes, but not all of them. A lot of routes are missing and can only be customized manually. To do this, open URL Aliases tab and add the desired route and its alias. For example:
account/account -> account
account/address -> address
Aliases can be set for each language separately and removed any time.