OCMOD Modification System opencart 2.3 example for Show all products module eCommerce

In this opencart guide, we are showing you the OCMOD Modification System of Opencart 2.3 with an example of the "Show all products module" eCommerce. Opencart 4 OCMOD documentation

Things to take care of while making an OCMOD file:

1. File extension must be either .ocmod.zip or .ocmod.xml.
2. Upload from the admin section, Admin>>Extensions >> Extension Installer, Upload the .xomod.zip or .ocmod.xml file from here.

Now go to the following link and download the "Display all Products" module Download shows all products module You will find the following OCMOD example which shows how to show "All Products" links at the top menu bar.  

For example:

OpenCart Version 2.2
2.0.0
Rupak Nepali
   List_all_Products



]]>
All Products
]]>

More details at https://github.com/opencart/opencart/wiki/Modification-System OCMOD is a system that allows store owners to be able to modify their store by uploading a compressed file that contains XML, SQL, and PHP files. If an OCMOD is developed correctly it can modify how a user's OpenCart store works without changing any of the core files. This means that if a modification is removed none of the original OpenCart files need to be restored or fixed.

OCMOD Files

OCMOD files can be uploaded via the opencart admin under Extensions / Extension Installer For an OCMOD file to be uploaded the file extension must be either .ocmod.zip or .ocmod.xml. This is to avoid none of the OCMOD files from being uploaded to a store user admin.

File Structure

Example file structure for OCMOD compressed files.

• upload
• install.sql
• install.php
• install.xml

upload

All files under this directory will be uploaded to the directory of your OpenCart installation.

install.sql

Add any create, drop, insert, and update SQL queries here. Make sure each query ends with ;

install.php

If the modification requires any custom PHP code.

install.xml

The XML modification file. You can view the documentation for this system below.

XML

This is the file that creates a virtual copy of any files that require changes. Use this system instead of overwriting any default installation files. Multiple modifications can be applied to the same file. Example OCMOD file:

    Modification Default
    1.0
    OpenCart Ltd
    http://www.opencart.com
    
        
            load->controller('common/column_left');
            ]]>
            
        
      

Tags

File

You can set multiple file locations by spiting up the file locations using commas. The modification system uses the PHP function glob. http://hk1.php.net/manual/en/function.glob.php Example: Direct file path.

Using braces allows for selecting multiple files and not having to repeat the code operation multiple times.

also allows braces

please note that all file paths must start with either admin, catalog, or system. you can also use wildcard *

Search

Search code Allowed Attributes

• trim="(true|false)"
• regex="(true|false)"
• index="(number)"

Example:

    Modification Default
    1.0
    OpenCart Ltd
    http://www.opencart.com
    
        
            load->controller('common/column_left');
            ]]>
            
        
      

Add

The code to replace the search with. Allowed Attributes

• trim="(true|false)"
• position="(Replace|Before|After)"
• offset="(number)"

(note position can not be used if regex is set to true in the search attribute). Example

    Modification Default
    1.0
    OpenCart Ltd
    http://www.opencart.com
    
        
            load->controller('common/column_left');
            ]]>
            
        
      

Regex

Allowed Attributes

• limit="(number)"

Example:

    Regex Example
    1.0
    OpenCart Ltd
    http://www.opencart.com
    
        
            
            
        
    

If you use regex you can not use attributes position, trim or offset as these are handled by the regular expression code you write. The limit attribute is still available. If, for example, you want to change the 3rd 'foo' to 'bar' on the following line:

lorem ifoopsum foo lor foor ipsum foo dolor foo
^1      ^2      ^3         ^4        ^5

Run:

s/\(.\{-}\zsfoo\)\{3}/bar/

Result:

lorem ifoopsum foo lor barr ipsum foo dolor foo
^1      ^2      ^3=bar     ^4        ^5

You can find more information about the regular expression PHP function OCMOD uses can be found here: http://hk2.php.net/manual/en/function.preg-replace.php More information about regular expression can be found here: http://www.regular-expressions.info