Module Settings Overview
After you have successfully linked your OCWP with a WordPress blog (explained in the previous chapter), you can access the OCWP module in Extensions > Modules > OCWP [Edit].
You will see the following dashboard:
Let's go through all settings and buttons to see what they do.
Clear OCWP OpenCart cache button (top-right)
The Clear cache button on the top right is used to clean your OCWP cache. Use this button after you edit content in your WordPress blog in order to make this new content visible in the OCWP modules.
NoteIn most cases you will not be using this button, since the OCWP WordPress plugin automatically clears the OpenCart cache whenever you save content in the WordPress admin panel.
NoteWhenever you load OCWP modules as a widget in your OpenCart front-end, the first page request will load the WordPress blog in your OpenCart system, which is a relatively heavy task. This is why we are utilizing the OpenCart cache system - to avoid loading the whole WordPress on each page load and use already cached content. The OCWP cache files have the ocwp. prefix for easier cleaning. The cache file names also contain the MD5 hash of the settings of the specific sub-module.
This tab contains settings which affect the whole OCWP system. They are the following:
|Setting Name||Setting description|
|Automatically clean OCWP OpenCart cache when clicking Save in OCWP modules||Enabled/Disabled - Determines whether the OCWP OpenCart cache will be automatically cleared whenever you edit an OCWP sub-module (explained later in this document).|
|Display link to WordPress blog in front-end main menu||Yes/No - Determines whether to show a link to the WordPress blog in the main menu of your OpenCart front-end.|
|Front-end main menu link name||The link name to your WordPress blog. This field is language-specific. Default value: WordPress|
|WordPress link position in front-end main menu||This value will not regard the Sort Order value you set for each menu item. Instead, the position you specify here will be regarded on top of the Sort Order of your menu items.|
|Global Custom CSS||Insert your custom CSS rules in the large text area. These rules will be applied on every OpenCart layout where you have assigned at least one OCWP sub-module. The CSS will not be applied for layouts where you have no OCWP sub-modules.|
This section allows you to create different OCWP modules. All of them are created as sub-modules of OCWP, which makes them visible in Extensions > Modules under the main OCWP module.
You can position each sub-module in your OpenCart front end from the System > Design > Layouts page. After you click the + button, a sub-module is automatically created and you are redirected to the module edit page. Modify your sub-module settings and click the Save icon on the top right.
For more information about the different types of modules, see the OCWP Sub-modules section in this documentation.
You will notice that the sub-module has an ID in the module name - this will allow you to locate the sub-module more easily in System > Design > Layouts (in case you have more than 1 sub-module of the same type).
To make things even easier for you, you can rename your OCWP module by clicking on the Pencil icon next to the module name:
Here is an example where we have created 2 Posts sub-modules, seen in Extensions > Modules.
The same 2 sub-modules are visible in the System > Design > Layouts page:
This section gives a few options to manage the WordPress system which is linked to your OpenCart.
Manage Your WordPress Blog
Here you will see a button called Re-install Plugins. If you press it, the plugins which are shipped with OCWP will be removed from your linked WordPress blog, and then they will be re-installed again. To learn about these plugins, please refer to Chapter 4 > OCWP plugins for WordPress.
There are also two buttons which lead to your WordPress installation:
- Go To WordPress Front - redirects you to your WordPress blog front page
- Go To Admin Panel - redirects you to your WordPress admin panel within OpenCart - note that you will be automatically logged in if you are already logged into the OpenCart admin panel
Provides you with an option to delete your WordPress installation. If you accidentally click the button, you will be prompted with an alert box just in case.
Be CarefulThis action cannot be reverted. Your WordPress blog will be physically deleted from your system. The blog's database tables will be deleted as well.
This section lists all of the errors which appear in your WordPress system. You can use it for debugging purposes. You also have the option to clear the log.
The log by default displays the first 1000 errors. If you want to see the rest, you should manually open up the OCWP error log file on: /system/logs/ocwp.log and also delete the WodPress error log file in /system/logs/ocwp.log.
This Error Log feature ensures that all WordPress-related errors will be saved in a separate file, which will prevent them from mixing up with the OpenCart errors.
The WordPress error log file is /system/logs/ocwp.log
Help & Support
This section lets you activate your OCWP module. This is necessary if you need support help or need to access the latest versions of OCWP. If you are using OCWP on a test installation, which is not LIVE, feel free to use it without entering a license.
There are also quick links for the iSenseLabs community forums, the iSenseLabs ticket system, and the iSenseLabs pre-sale contact email for all sales-related questions. We are here to help if you are having any difficulties with OCWP.