Knowledge Base - Tutorial Easy Category plugin for Sobi2

Plugin installation

You just download the plugin. For that you received by email a download link that contains the order number like 1234567890. Keep this email, with them you can download the updates.

Open your site backend, and select the menu Components > Sobi2. Once in the component Sobi2, go to the side menu plugin > Plugin Manager.

plugin_cat1

Click the browse button and select the file plugin_import.zip. Click install and the plugin should be installed. In case of installation error:

  • Check writing privileges (CHMOD) in the folder 'com_sobi2/plugins' in 'components' and 'administrator / components'
  • Try to install an official plugin like Gallery from Sigsiu.net
  • Perform a system check in Sobi and correct any errors

plugin_cat2

Once installation is complete, you will be asked for for an order, enter the number (for exemple: 123456789) which we mentioned above. Click save.

plugin_cat3

You will now see a message in green indicating that the registration is correct and that the version is updated. Note: Your version may be newer than the server, because we do not publish necessarily minor update.

Finalising installation

This plugin replaces the category manager of Sobi. For this reason, there are some small adjustments to be made manually to complete the integration of the plugin. These adjustments cannot be do in the installation process.

Disable the Sobi2 category management

It is necessary to remove the function that displays the choice of categories. This does not change the core code of Sobi, and you can update the component without problems. Follow these simple steps:

  • Go into Component > Sobi2 > Configuration > Registry Editor
    Locate the key cats_selection in the section edit_form
    Change the value of 1 to 0
    Locate the key cats_selection_adm in the section edit_form
    Change the value of 1 to 0
    Click on save (on the top)

plugin_cat4

Include verification of selected categories of Sobi2.

It must indicate what function Sobi2 use to verify that at least one category is selected. This does not change the code of Sobi2, and you can update the component without problems. For that you must follow these simple steps:

  • Go into Component > Sobi2 > Configuration > Registry Editor
    Locate the key cat_select_callback_func in the section edit_form
    Change the value of 0 to validateCategories
    Click on save (on the top)

plugin_cat5

Until the version 2.9.2.3 (-> april 2010), Sobi2 contains a small bug in the code (it was reported here). To enable the check that at least one category is selected, you must change the code of Sobi2. For this correction we need to modify the core code of the component, it will be lost during a future update of the component, and this operation will therefore be repeated. This bug is corrected since the version 2.9.2.4. Follow these simple steps:

  • The file to edit is located here: components/com_sobi2/form.class.php
  • Use your ftp client or a component such as eXtplorer to edit the file form.class.php
  • Find the line 1414 in the file (line number may vary depending on the version of Sobi2)
  • Find the following text:
  • * if( $f = $config->key( "edit_form", "cat_select_callback_func", false ) && function_exists( $f )) {
  • And replace it (by adding a pair of parentheses):
  • * if( ($f = $config->key( "edit_form", "cat_select_callback_func", false )) && function_exists( $f )) {
  • Save the file, and... voila.

plugin_cat6

Applies To

All Products