Congratulations on your purchase of an OpenCart template! This documentation consists of several parts and describes the installation, configuration and setting up an OpenCart website process.
We did our best to make this manual information to be presented in a simple way. As an effective reference, the documentation below will provides all information you need, it has been restructured in different chapters, you can see in the left-side menu. You are able to navigate to any part of the documentation using the active content headers' links.
We recommend that you should start reading the documentation at the first section.
OpenCart — is an Open Source e-commerce application. OpenCart provides easy customization of your online store. OpenCart community includes a number of users starting from the experienced web developers looking for the user-friendly interface, ending with shopkeepers that start their online business for the first time. OpenCart provides a great amount of features that allow you to control your store. Using OpenCart tools you can easily uncover the store potential.
Document Opencart What`s new in Opencart 4
Note
Usually there is a vast of different settings that available with a new Template, and because this is an open source software, it isn't always the same for each developer. Make sure to read through this documentation available for the Template that you are installing so that you know what features are available for you.
System Requirements for Opencart:
Click here Note: Opencart 4 Requirements Software: PHP 8.1+ (8.1+ recommended)Note:
Make sure your PHP value requirements look like:
max_execution_time=3000
max_input_vars = 25000
post_max_size=350M
upload_max_filesize=200M
Make sure your MYSQL value requirements look like:
max_allowed_packet=16M
In this article, we will guide you some instructions and tips in term of configuration on OpenCart Theme.
Click hereYou read user-guide to install default OpenCart:
Click hereUser-guide to install So Theme
Video to view user-guide to install So Theme
Unzip so_emarket_theme_oc4023_home1_to_home38_v2.1.3.UNZIPFIRST.zip
file - (If you want to use Homepage 1 to Homepage 38) to get the files: so_theme.ocmod.zip
and image.zip
Go to Extensions › Installer › Click Upload and select the so_theme.ocmod.zip
file to upload and wait to the message.Then you will see the message Success: The extension has been uplloaded!
Note:
If you can't upload success. Please upload the so_theme.ocmod.zip
file to: system/storage/marketplace/ folder.
The next, please Click install So Emarket
Then you will see the message Success: You have modified extensions!
Go to Extensions › Extensions > Choose the extension type Module › Click Install button on Theme Control Panel
Go to System › User › User Group › Click Edit button › Then you click Select All button and click the Save button
Please upload the image.zip
file to your root file. Use cpanel account to unzip it. Move all folders in the ‘image’ folder >> the ‘image’ Root folder
Go to Extensions › Extensions > Choose the extension type Module › Click Editthe button on Theme Control Panel
then select your layout by click: Apply Default Setting button on General Tab then click the Save button
index.php?route=extension/so_theme/simple_blog/article
or Admin > Menu Simple blog > General Setting > Simple Blog Seo Keyword Heading (This name will be as seo keyword when simple blog is clicked)Note
When you install multi language the default language is arabic, it is not an error. Please You enter your content
Note
Because there are so many modules, Select the module you would like to translate. Insert translations into the content
If the module has language files for English and you want to translate them for Spanish, then at the very first copy all the language files from English language directory and paste all of them in Spanish directory in the same structure as it was in English language.
patch_language_oc4.x
- patch_language_oc4.x\extension\so_theme\admin\language\en-gb
- patch_language_oc4.x\extension\so_theme\catalog\language\en-gb
To your language: replace "en-gb" with the Locale of your language (English, German, Spanish, Arabic ...).
This is the most important part when optimize OpenCart speed that you need to minify CSS, javascript and other files using gzip/ Enable GZIP Compression, enable browser caching.
Secondly, rename htaccess.txt to .htaccess in your OpenCart directory.
Then, open the .htaccess file and add the following code underneath the ReWrite rules
# Compress HTML, CSS, JavaScript, Text, XML and fonts
AddOutputFilterByType DEFLATE application/javascript
AddOutputFilterByType DEFLATE application/rss+xml
AddOutputFilterByType DEFLATE application/vnd.ms-fontobject
AddOutputFilterByType DEFLATE application/x-font
AddOutputFilterByType DEFLATE application/x-font-opentype
AddOutputFilterByType DEFLATE application/x-font-otf
AddOutputFilterByType DEFLATE application/x-font-truetype
AddOutputFilterByType DEFLATE application/x-font-ttf
AddOutputFilterByType DEFLATE application/x-javascript
AddOutputFilterByType DEFLATE application/xhtml+xml
AddOutputFilterByType DEFLATE application/xml
AddOutputFilterByType DEFLATE font/opentype
AddOutputFilterByType DEFLATE font/otf
AddOutputFilterByType DEFLATE font/ttf
AddOutputFilterByType DEFLATE image/svg+xml
AddOutputFilterByType DEFLATE image/x-icon
AddOutputFilterByType DEFLATE text/css
AddOutputFilterByType DEFLATE text/javascript
AddOutputFilterByType DEFLATE text/xml
# Remove browser bugs (only needed for really old browsers)
BrowserMatch ^Mozilla/4 gzip-only-text/html
BrowserMatch ^Mozilla/4\.0[678] no-gzip
BrowserMatch \bMSIE !no-gzip !gzip-only-text/html
Header append Vary User-Agent
## EXPIRES CACHING ##
ExpiresActive On
ExpiresByType image/jpg "access 1 month"
ExpiresByType image/jpeg "access 1 month"
ExpiresByType image/gif "access 1 month"
ExpiresByType image/png "access 1 month"
ExpiresByType text/css "access 1 month"
ExpiresByType application/pdf "access 1 month"
ExpiresByType text/x-javascript "access 1 week"
ExpiresByType application/x-shockwave-flash "access 1 month"
ExpiresByType image/x-icon "access 1 month"
ExpiresDefault "access 1 month"
## EXPIRES CACHING ##
# gzip #
AddOutputFilterByType DEFLATE text/text text/html text/javascript text/plain text/xml application/xml text/css application/x-javascript application/javascript
# remove browser bugs
BrowserMatch ^Mozilla/4 gzip-only-text/html
BrowserMatch ^Mozilla/4\.0[678] no-gzip
BrowserMatch \bMSIE !no-gzip !gzip-only-text/html
Header append Vary User-Agent
# gzip end #
Go to admin › OpenCartWorks › So Themes Config › Advanced Tab
Setting value : Show Minify CSS = On, Show Minify JS = On
Go to OpenCartWorks › So Themes Config › General Tab
1.Select Layout - Choose the layout that you like. Click button Apply Default Setting Choose the Layout
New Color
- Set name color (do not uppercase letters) and fill color. Continue Click button Compile CSS. Select Color
- Select the color you just created › Click button Save2.Sticky Menu on Top - When the user scrolls the page, Sticky Menu to the top of the browser window during scrolling
Status
- Option (yes|no)Select Block on header
- Choose your parts you want to show on the sticky Menu3.Top Bar
Telephone No
- is the content of TelephoneWelcome Message
- is the content of Welcome MessageCheckout Link
- show the link checkoutLanguage/Currency
- show the Language/Currency View Frontend:
4.General
Preloader
- want to show the PreloaderPreloader Animation
- Choose the preloader that you likeStatus Payment
- want to show the PaymentImage (Payment block)
- Choose a image path Copyright
- It is the content to CopyrightView Frontend:
Choose the type of Header that you like, to pair with home page
Hover over image below to see effect.Choose the banner that you like
Go to admin › OpenCartWorks › So Themes Config › Layout Tab › With the boxed layout you can choose additional options such as custom background images, patterns and solid colors
Layout Style
- Select one in option (Default|Layout fluid|Layout boxed) Body Background Color
- Set background color for MainbodyOverlay pattern
- Set pattern image for MainbodyBackground Image:
- Set background image for MainbodyBackground Image display mode
- Set background image display modeBackground Image display Attachment
- Set background image display attachmentView Frontend: Layout Style = boxed
Go to admin › OpenCartWorks › So Themes Config › Page Tab › Product Category
1.Layout Category & Product
Display column position
- Select one in option ( Outside content| Inside content)Display column type
- Add page content inside this div if you want the side nav to push page content to the rightSticky Sidebar
- Attach sidebar to the page when the user scrolls such that the element is always visible2.Category Info
Display subcategory
- You want to show the subcategoryChoose subcategory grid number
- Quantity is displayed subcategoryDisplay category info
- You want to show description categoryChoose Product grid number
- Column number display page category3.Product Item
Show "Discount"
- Options (yes/no) Show countdown
- Show countdown of Special Offer productShow Ratings
- Options (yes/no)Show Orders
- show order number of productShow image gallery
- Slider image galleryStatus use placeholder images
- Options(yes/no)4.Group Cart
Show position cart info
- select align (Left|Right|Center|Bottom) position group cartShow "QuickView" Button
- Options (yes/no)Show "Addtocart " Button
- Options (yes/no)Show "Wishlist " Button
- Options (yes/no)Show "Compare " Button
- Options (yes/no)View Frontend: The options on the create Menu features
Go to admin › OpenCartWorks › So Themes Config › Page Tab › Product Category › Product page
1.Options Styles
Option Checkbox and Radio Style
- refreshing the default option is more beautiful2.Product Page
Product gallery
- Select one in option ( Gallery Bottom| Gallery Left| Gallery Grid | Gallery list | Gallery Slider)Enable Product Zoom
- Options (yes/no)Enable Size Chart
- add product image size chart Tabs block
- Select one in option(vertical|horizontal)Enable Button Show More
- Add button (show more) on product description, click button (show more) show full descriptionShow Shipping & Payment
- Add new tabs Shipping & Payment 3.Social Share
Show Custom
- Options (yes/no) Custom Content
- Write content to Custom4.Social Share
Show Related
- Options (yes/no) Related product number per row
- Column number display related productView Frontend: The options on the create Menu features
Go to admin › OpenCartWorks › So Themes Config › Page Tab › Coming Soon
Coming Soon Background
- Set background image for Coming Soon Coming Soon Title
- is the heading of Coming SoonDate
- is the dates of coming soonContent
- is the content of coming soon View Frontend:
Go to admin › OpenCartWorks › So Themes Config › font Tab
Font Setting standard
- It is the default fonts of the system Font Setting Google Fonts
- It is the Google fonts, fast, and open through great typography.Google URL
- Example: http://fonts.googleapis.com/css?family=Roboto:400,500,700 ⇒ View MoreGoogle Family
- Example: Roboto, sans-serif;Add css selectors
- is the css selectors of setting Go to admin › OpenCartWorks › So Themes Config › custom Tab
CSS Input
- It is the css code direct CSS File
- add file css, Enter file path file cssJS File
- add file js, Enter file path file jsGo to admin › OpenCartWorks › So Themes Config › Advanced Tab
SCSS Compile
- Compile scss source for get css styles using User Developer Compile Muti Color
- Only user developerShow Minify CSS
- compress all css to only one fileShow Minify JS
- compress all js to only one fileChange the image type jpg , png , gif => webp
- by add the code below before at the line 62 of this file catalog\model\tool\image.php
if($extension == 'jpg' || $extension == 'png' || $extension == 'gif' || $extension == 'jpeg') { $dir = DIR_IMAGE; $name = $image_new; $newName = substr($image_new, 0, strrpos($image_new, '.')) . '.webp'; // Create and save if (!is_file(DIR_IMAGE . $newName)) { if ($extension == 'jpeg' || $extension == 'jpg') $img = imagecreatefromjpeg($dir.$name); elseif ($extension == 'gif') $img = imagecreatefromgif($dir.$name); elseif ($extension == 'png') $img = imagecreatefrompng($dir.$name); imagepalettetotruecolor($img); imagealphablending($img, true); imagesavealpha($img, true); imagewebp($img, $dir . $newName, 100); imagedestroy($img); } else { if ($extension == 'jpeg' || $extension == 'jpg') $image_new = $newName; elseif ($extension == 'gif') $image_new = $newName; elseif ($extension == 'png') $image_new = $newName; } }
Go to admin › OpenCartWorks › So Mobile › General
1.Select Layout - Choose the layout that you like. Click button Apply Default Setting Choose the Layout
New Color
- Set name color (do not uppercase letters) and fill color. Continue Click button Compile CSS. Select Color
- Select the color you just created › Click button Save2.Platforms
Mobile Status
On - use layout mobile/ Off - use layout responsiveLogo Mobile
- Choose a image path Sticky Top Bar
- Attach sidebar to top the page when the user scrolls Copyright
- It is the content to CopyrightGo to admin › OpenCartWorks › So Mobile › Bottom Bar
Show Bottom Bar
- Options (yes/no)Show Menu More
- Options (yes/no) View Frontend:
Go to admin › OpenCartWorks › So Mobile › Left Bar
Show Search
- Options (yes/no)Show Main Menu
- Options (yes/no) Show All Category
- Options (yes/no) Show Category
- Options (yes/no) Show Wistlist
- Options (yes/no) Show Compare
- Options (yes/no) View Frontend:
Go to admin › OpenCartWorks › So Mobile › Page
More Category Button
- Options (yes/no)Compare Button
- Options (yes/no) Wishlist Button
- Options (yes/no) Addtocart Button
- Options (yes/no) View Frontend:
Go to admin › OpenCartWorks › So Mobile › font Tab
Font Setting standard
- It is the default fonts of the system Font Setting Google Fonts
- It is the Google fonts, fast, and open through great typography.Google URL
- Example: http://fonts.googleapis.com/css?family=Roboto:400,500,700 ⇒ View MoreGoogle Family
- Example: Roboto, sans-serif;Add css selectors
- is the css selectors of setting Go to admin › OpenCartWorks › So Mobile › Advanced
SCSS Compile
- Compile scss source for get css styles using User Developer Compile Muti Color
- Only user developerThere are two ways to configure Extensions of this Theme:
Option 1: Go to Admin Control Panel => OpenCartWorks => So Page Builder => Select the Layout you want.
Themes is using extensions:
Option 2: Go to Admin Control Panel › Extensions › Extensions › Choose the extension type: Modules => And choose the module you want.
Go to Admin Control Panel => OpenCartWorks => So Page Builder => Select the Layout you want.
Note
Home 1 is made from So Page Builder (Home 1 + Footer 1), similar as other Home page
1.Example So Page Builder : Edit Home 1
It will list all modules in the home page 1, You want to edit the module then click edit it
2.Example So Page Builder : Edit Footer 1
It will list all modules in the Footer 1, You want to edit the module then click edit it
3.Example So Page Builder : Edit Mobile Page Builder - Home 1
If you have any question that is beyond the scope of this help file, please send us via: Submit a Ticket
Our working hours: Monday to Friday 8AM - 5PM GMT+8.
Thank you so much for purchasing this theme!
Note
Note: We have right to answer or not answer you how to edit the theme's source code.