AC CMS Opencart Extension I. Features...2 II. Install...3 III. Upgrade...3 IV. Manage Articles...4 V. Manage Categories...6 VI. Manage Comments...7 VII. Manage Article Sets...7 VIII. Place Article Set... 10 IX. Manage Menu... 10 X. Global Settings... 11 XI. Modules... 12 XII. Customization... 12
I. Features Multi Languages Multi Store Multi Categories RSS feed per category and blog (can be turned off) RSS SEO URL Autofill SEO Keyword Email notification about new comments to Admin Related articles in product view Access Control (Public / Registred) - Article - Comment Display types for Article Set - Default - Accordion - Slideshow - Tabs Menu Manager Comments o Built-in comment system o Facebook comment system o Disqus comment system SEO Article Search Build your own modul with article set Article Tags Publishing date range options for articles Related Products Related Articles Sitemap Layout and other (hide author, hide created date, etc) override options for categories and articles External CSS file VQ MOD 2
II. Install 1. Install VQ MOD if you don t have it (http://code.google.com/p/vqmod/). 2. Unrar ac_cms2.x.rar file. 3. Upload all files from upload directory to your opencart root 4. If your Opencart version is 1.5.1.0-1.5.1.2, then you have to upload files from opencart_1.5.1.0-1.5.1.2_mod/upload. (startup.php will be overwritten, but don t worry, these are only helpers from latest version of Opencart) 5. Type url: http://yoursite.com/install/ac_cms 6. Click install button 7. Click install button again 8. If there were no errors delete the install folder 9. Login to your webshop as admin 10. Go: Extensions/Modules and install all AC CMS modules 11. Go: System->Users->User Group-> Top Administrator and add modify and access permission to AC CMS 12. Click on AC CMS menu and then global settings. Set blog name and other options. 13. Go: Sytem->Design->Layouts->insert the following layouts: - Layer Name: Article - Route: ac_cms/article - Layer Name: Article Category - Route: ac_cms/category - Layer Name: Blog - Route: ac_cms/blog III. Upgrade 1. Unrar ac_cms2.x.rar file. 2. Upload all files from upload directory to your opencart root 3. Read the changlog, if database changed then follow these steps, otherwise delete the install folder and you are done. a. Type url: http://yoursite.com/install/ac_cms b. Click upgrade button c. Click upgrade button again d. If there were no errors delete the install folder 3
IV. Manage Articles GENERAL Title: Set article title. Description: Write content here. Use Read More button to separate intro text from main text. Meta Tag Description: Set article meta description and article description for RSS. Meta Tag Keywords: Set article meta keywords. Article tags: Set article tags. DATA Start Date: Publish article from that date. If it s empty, or 0000-00-00 00:00:00, then this option will be ignored. End Date: Stop publishing article from that date. If it s empty, or 0000-00-00 00:00:00, then this option will be ignored. SEO Keyword: Set article SEO keyword. If it s empty then the current article s title will placed here. Image: Set article thumbnail image. Article Set will use this. Sort Order: Set article sort order. Remove from Blog : Remove article from all category/all article list. Access Level: Set the Access Level for Content (Public / Registred) Status: Set article status. 4
COMMENT Allow Comments: Allow users to comment. Auto Approve Comments: Auto approve user comments. Comment Notification Email: If comment notification is enabled, the admin will receive an email when someone else leaves a comment. Access Level: Set the Access Level for Comment (Public / Registred) LINKS Category: Set article category. Store: Choose store where you want to show your article. Related Product(s): Search for related product. Related Article(s): Search for related article. DESIGN Layout Override: Set article layout. If you want a unique layout desing for an article, then go to System -> Design -> Layouts, click Insert, set Layout Name and save the form. Go back to your article and select the newly created layout. Override Global Settings: If you check this checkbox, you will override the global settings and the following options will be aviable: Hide Author : Hide author in current article. Hide Created Date : Hide created date in current article. Hide Categories : Hide category list in current article. Hide Number of Comments : Hide number of comments in current article. Hide Modified Date : Hide modified date in current article. Hide AddThis : Hide AddThis in current article. 5
Hide Facebook Like Button: Hide Facebook Like Button in current article. Hide Viewed: Hide viewed in current article. V. Manage Categories GENERAL Category Name: Set category name. Description: Set category description. Meta Tag Description: Set category meta description and category description for RSS. Meta Tag Keywords: Set category meta keywords. LINKS Parent Category: Set parent category. Store: Choose Store where you want to show your category. SEO Keyword: Set article SEO keyword. If it s empty then the current category s name will placed here. It must be globally unique. Image: Set category image. RSS: Enable / Disable RSS feed for current category. Sort Order: Set category sort order. Status: Set category status. 6
DESIGN Layout Override: Set category layout. If you want a unique layout desing for a category, then go to System -> Design -> Layouts, click Insert, set Layout Name and save the form. Go back to your category and select the newly created layout. Override Global Settings: If you check this checkbox, you will override the global settings and the following options will be aviable: Hide Author : Hide article author in current category. Hide Created Date : Hide article created date in current category. Hide Categories : Hide article categories in current category. Hide Number of Comments : Hide article number of comments in current category. Hide Modified Date: Hide article modified date in current category. VI. Manage Comments Author: Set comment author. Article: Search for an article to comment. Text: Set comment text. Status: Set comment status. VII. GENERAL Manage Article Sets Article Set Title: Set modul name. 7
DATA Display: Set Display Type for Article Set (Default / Accordion / Slideshow / Tabs(Article)/ Tabs(Category)) Select Categorie(s): Select category which will be the source of article set. Select Article(s): Search for articles which will be the source of article set. (it can be mixed with categories) Leading Articles amount: Set number of leading article(s). Column settings will be ignored (100% width). Articles amount: Set number of articles to show. Sort By: Sort articles by: title, author, viewed, article sort order, created date, modified date. Sort Order: Set articles sort order (ASC/DESC). Columns: Set the number of columns. Position: Drag and drop to sort title, info, image, text, read more elements. Title Order: Set article title order (disabled, left, right, center). Info Order: Set article info order (disabled, left, right, center). Image Order: Set article image order (disabled, left, right, center). Text Order: Set article text order (disabled, left, right, center, justified). Read more Order: Set article read more order (disabled, left, right, center). Text as Link: Set article text as link. 8
Image as Link: Set article image as link. Title as Link: Set title as link. Hide Author: Hide article author. Hide Modified Date: Hide article modified date. Hide Created Date: Hide article created date. Hide Categories: Hide article category list. Hide Number of Comments: Hide article number of comments. Maximum Chars in Title: Set number of article title characters to display. Maximum Chars in Content: Set number of article text characters to display. Keep HTML Tags in Content: If you need to keep all HTML tags (text formatting, etc) in articles intro text, then use this option. But only works if you leave "Maximum Chars in Content" empty. Articles Image Height: Set articles image height in pixel. Articles Image Width: Set articles image width in pixel. Articles Image Margin: Set articles image margin in pixel. 0px 0px 0px 0px(up right bottom left). Slideshow Caption Margin-Top: Set top margin for slideshow caption. Only available if display type is Slideshow Slideshow Width: Set width of slideshow. Only available if display type is Slideshow. Slideshow Height: Set height of slideshow. Only available if display type is Slideshow. 9
VIII. Place Article Set Article Set: Choose article set. Layout: Set layout for article set. Position: Set position for article set. Status: Set status. Sort Order: Set sort order for article set. IX. Manage Menu Category Article Result case1 Select All Select All Blog case2 Select One Select All Category in top menu with it's articles in submenu case3 Select One Select One Article in top menu Don t forget to add articles to article category. Category: Select category. If you choose Select All then you activate blog view. In that case the menu name will be what you had set in global settings/blog name. Article: Set the previously selected category s article to show as menu-item. If you choose Select All, then the menu-item name will be the category name and the articles will listed as sub-items. Columns: Number of columns to use for the articles. Articles Amount in Submenu: Set number of articles in submenu (case2). Leave empty to display all articles in category. Status: Enable/Disable menu-item. Sort Order: Set menu-item position. First position is 0. 10
X. Global Settings Store: Select store for global settings. BLOG Blog name: Set blog name. Meta Tag Description: Set blog meta description and blog description for RSS. Meta Tag Keywords: Set blog meta keyword. DATA Blog RSS: Enable / Disable Blog RSS feed. Articles Per Page: Set articles per page. Hide Author: Hide author in all articles. Hide Modified Date: Hide modified date in all articles. Hide Created Date: Hide created date in all article. Hide Categories: Hide category list in all articles. Hide AddThis: Hide AddThis in all articles. Hide Facebook Like Button: Hide Facebook Like Button in all articles. Comments Per Page: Set comments per page. Hide Number of Comments: Hide number of comments in all articles. Comment Engine: AC CMS (default built-in system), Facebook Comment System, Disqus Comment System. 11
Facebook Comment Admin(s) ID: Available if comment engine is Facebook. To moderate, you need to list yourself as an admin. To add multiple moderators, separate the uids by comma without spaces. uid = FACEBOOK_USER_ID. A bit difficult to find out your user id, but you can try with this: https://graph.facebook.com/your_profile_name FB Comment Container Width: The width of the Facebook container. Disqus Shortname: A shortname is the unique identifier assigned to a Disqus site. All the comments posted to a site are referenced with the shortname. Disqus Force Multilang: Force Disqus to use Opencart's current language. XI. Modules Make your own modules with article sets. Select category / categories or articles which will be the source of article set, then set sort by option (title, author, viewed, article sort order, created date, modified date), sort order (ASC/DESC), image size, and much more. Category module. XII. Customization AC CMS like Opencart uses a "default theme fallback system". This means that if you are missing a file in your custom theme folder, it will search the main "default" theme folder for the file. NEVER edit the files in the "default" theme directly. This is your base and fallback. When new upgrades are released, this folder gets overwritten with the latest code. If you want to edit tpl or css file, you should copy it from default theme to yours Example catalog\view\theme\default\template\ac_cms\xy.tpl catalog\view\theme\yourtheme\template\ac_cms\xy.tpl <- edit this one More info http://www.opencart.com/index.php?route=documentation/documentation&path=43_44 Default theme modifications with vqmod 12
Open vqmod/xml/ac_cms.xml scroll to the bottom and there you can find the following modifications what you should add to your theme: (Added Related Articles list to product view) <file name="catalog/view/theme/default/template/product/product.tpl"> (Added Search in Articles button to product search) <file name="catalog/view/theme/default/template/product/search.tpl"> (Added Article Categories to sitemap) <file name="catalog/view/theme/default/template/information/sitemap.tpl"> More info (how to read this file) http://code.google.com/p/vqmod/wiki/examples External css file: catalog/view/theme/default/stylesheet/ac_cms.css. 13