Skip to content
Home SobiPro Upgrade to SobiPro 1.1
Upgrade your SobiPro to 1.1

SobiPro 1.1 has a complete new user interface in administration area. This interface uses the Bootstrap Framework as it is also used by Joomla! 3.0+. But SobiPro brings Bootstrap even to your Joomla! 2.5 directory so you will benefit from the new features in both Joomla! versions.

The main reason why we re-designed the SobiPro administration interface is not only the design, but the usability. The workflow of SobiPro administration interface goes now more smoothly and is built more user-friendly.

Upgrade SobiPro from version 1.0.8 to 1.1.x can be done easily. Although there are some things to consider and changes have to be made on your site. Please read the following carefully before you start your upgrade.

What needs special attention

Please take care of the new requirements and changes, otherwise your upgrade won't be successful.

The required PHP version

Attention! SobiPro 1.1 does NOT any longer work on PHP versions below 5.3.
So if you use PHP 5.2.x or older, update your PHP version before you upgrade your SobiPro!! If you are not able to update your PHP version by yourself, please ask your hosting provider to do so. For more information about how outdated PHP 5.2 is you can read this article by Nicholas Dionysopoulos.

The Joomla! version

SobiPro 1.1 is no longer designed to work on Joomla! 1.5. There are several known problems with SobiPro on Joomla! 1.5 (e.g. with Joomla! Menu Manager). On top of that, take into account that Joomla! 1.5 reached it's EOL (end of life) by late 2012, and even Joomla's Extension Directory has stopped listing 1.5 only compatible extensions. We highly recommend to upgrade your Joomla! first to 2.5 before upgrading SobiPro to 1.1.

Language Files

SobiPro has a lot of new language texts which are not yet translated. They mostly concern the administration interface. There is a new translation project on Transifex and all translators are invited to help with the translation.

Applications

All applications needs to be revised to get also the new design of the administration interface of SobiPro 1.1. However, they should work in a so called legacy mode.

Category Selection

SobiPro 1.0 has an integrated standard category chooser, SobiPro 1.1 now has a Category Field instead. The possibilities of the Category Field are wider than the old standard chooser. As the standard chooser is removed, you need to add the Category Field to each section of your directory. Dependant on your Joomla! template, there may be also some style adoptions for front-end 'add/edit entry form'.
Please note, the old category chooser does not longer work. It needs to be replaced by a category field.

Option List Fields need special attention

In SobiPro 1.1, underscores are replaced with scores in field aliases. This change also affects fields that have option lists (single select, multiple select, checkbox...): option names will have underscores (_) replaced with "normal" scores (-).
In SobiPro versions below 1.1.5, this will result in the loss of data for those fields in already existing entries, as stored values have underscores on them. This is a bug, and is solved in SobiPro 1.1.5.

New ACL permission for Search function

A new ACL permission for the SobiPro search function is now available. This permission has to be added to all existing rules where the front-end search should be available for a specific user group.

Additional redirects for Entry Views

For the Entry Views there are now three different redirects available. However, the redirection 'Unauthorized Access to an Entry' has been replaced by the redirection 'Entry Views -> Details View'. The data won't be taken during the upgrade. It is necessary to add them later again.

The Default Template

SobiPro 1.1 has a new default template (default2) which uses Bootstrap. By changing the name of the default template we ensure that your old default template won't be overwritten (as we know that a lot of users still uses the default template instead of a duplicated one).

SobiPro URLs

In SobiPro 1.1 the method for creating URL addresses has been changed. At this moment they are created from the alias. As a result of this, after updating from SobiPro 1.0.x all URLs will contain underscores (_) instead of scores (-).
To get proper URLs it is necessary to re-save all existing entries and categories which have underscore signs in the alias. As for categories it must be done manually; for entries, import/export application can be used to replace all of them at once. It only needs to export id and field which stores name of the entry and import it back using update mode. After this all aliases will be automatically regenerated, and underscores will be changed to scores.



The Upgrade Process

Perform the following steps to upgrade SobiPro 1.0 successfully to SobiPro 1.1.

  • Backup your site
    Use Akeeba Backup or any other backup tool to backup your site before you install SobiPro 1.1.

  • Install SobiPro 1.1.x
    It is recommended to try out the upgrade first on a copy of the site (made e.g. with Akeeba Backup).

    SobiPro 1.0.8 is required for the upgrade process. If you have a version below SobiPro 1.0.8 installed, you have to update to SobiPro 1.0.8 first!

    To upgrade SobiPro 1.0.8 to SobiPro 1.1.x on an existing Joomla! 2.5 site, simply install the SobiPro 1.1 Full version. Do not un-install your previous SobiPro version!
    Go to Extensions > Extension Manager > Install and install SobiPro 1.1. Joomla! performs automatically a database update. All files will be overwritten.

    If you really need to upgrade SobiPro on Joomla! 1.5, you need to install the Clean Version, which is available for our Silver and Bronze club members. But keep in mind, there will be some glitches on Joomla! 1.5. You will also move all files and folders from media/sobipro/icons to media/sobipro/images manually.

  • Clear your browser's cache
    Now you can explore the new SobiPro administrator interface.

  • Re-save your Joomla! menu items
    Go to Joomla! Menu Manager and re-save all menu items for SobiPro.

  • Remove the old Category Chooser from the template
    While within the section, click on Section Template > entry > edit.xsl. From this file remove the template instructions starting with
    <div id="osx-modal-content">
    until right before the for-each loop of the fields.

    Attention! This may be different if you use a customized template.

  • Add a Category Field (Select Lists)
    For each of your sections, you need to add the new Category Field.
    From the SobiPro CPanel, click onto <your section name>. From the left menu within the section select Section Configuration > Fields Manager. Now on the upper right menu click Add New > Category to add a Category Field. Label it and save the field.

  • Add a Category Field (SigsiuTree - inline)
    There are now different types of category chooser in the field. If you want to use the former 'SigsiuTree', you need to select this for the method in the field's settings. Choose also 'inline' to show the tree directly within the entry input form.

    Probably you need to tweak your CSS a bit. E.g. by adding to the css > edit.css file the following:
    .SigsiuTree .tree {
    	float: left;
    	overflow: scroll;
    }
    .SigsiuTree .selected {
    	float: left;
    	margin-left: 30px;
    }
    .SigsiuTree .selected select {
        min-height: 200px;
        min-width: 150px;
    }
    .SigsiuTree .buttons {
    	clear: both;
    	padding: 10px;
    }
    .SigsiuTree .buttons button {
    	margin: 5px;
    }

  • Add a Category Field (SigsiuTree - Modal Window)
    If you want to use the former 'SigsiuTree' within a popup window, the same as the old standard category chooser, you need to select this for the SigsiuTree method in the field's settings. Then the setting SigsiuTree appears and in Output Style, you have to click on Modal Window. Additionally you need to add Bootstrap to your template. Please note, that adding Bootstrap will change the layout of the elements. Probably you will need to do some more styling to your entry input template!
    In your template file entry > edit.ini add 'bootstrap.bootstrap' to the list of 'css_files'. Also add 'bootstrap' to the list of 'js_files'. Probably you can remove 'osx' and 'simplemodal' from the list if you haven't customized your template with functions which need these files.

    Adding these CSS styles to the css > edit.css file. Other customizations may be needed depending on the Joomla! template you are using.
    .spFieldCheckbox,
    .spFieldRadio {
        float: left;
    }
    .SobiPro label {
    	display: inline;
    }

  • Entry input validation
    SobiPro 1.1 uses now AJAX to validate the input. This is coupled to Bootstrap. To get the former input validation working again on your existing SobiPro template without Bootstrap, add the following code at the end of the file js > edit.js of your template.
    window.addEvent( 'domready', function() {
        $( 'spEntryForm' ).addEvent( 'submit', function( ev ) {
            if( $( 'SP_task' ) == 'cancel' ) {
                return true;
            }
            else if( !( SPValidate( $( 'spEntryForm' ) ) ) ) {
                new Event( ev ).stop();
                return false;
            }
        } );
    } );

  • Add the icons CSS file to your template
    Ihe Image Field has changed it's behaviour. Images are uploaded now separately. The new image upload field used in the entry input form, needs several icons which are installed with SobiPro. To see these icons you need to add 'icons' to your template file entry > edit.ini 'css_files' list.
    For the old default SobiPro template the line should look like:
    css_files = "default, edit, icons"
    It may differ if you are using a customized template.

  • Add the search permission to existing rules
    On the upper right side, click Menu > Access Control List. Now edit each rule and add the front-end permission 'section > use search function' for all user groups you want to let use the SobiPro front-end search for the specific section.

  • Add missing entry redirection
    If you used in the past the redirection 'Unauthorized Access to an Entry', you need to add the necessary data again. From the SobiPro CPanel, click onto <your section name>. From the left menu within the section select 'Section Configuration > General Configuration'. Click on Redirects > Entry Views and add the data for 'Details View'.

  • Clean and rebuild caches
    At the end, for each section select Section Configuration > Section Crawler and on the upper right side select Clean Cache & Crawl.



SobiPro on Joomla! 3.x

SobiPro 1.1 works for Joomla! 3.x. If you update your Joomla! from 2.5 to 3.x with SobiPro installed, please consider the following:

  • Before you upgrade Joomla!, un-install the 'SobiPro Admin Menu' from Extensions > Extension Manager > Manage. It won't work on Joomla! 3.x.



Upgrading SobiPro applications

Using Review & Ratings App 2.0 with old SobiPro 1.0 templates
Reviews & Ratings version 2 comes with two new views for SobiPro 1.1: most-rated and top-rated.
These views are generated with the new default2 template in mind, so you need modifying their xsl as follows in order for them to work with old 1.0 templates.

The following lines must be removed/commented:

<xsl:include href="/../common/messages.xsl" />

and

<xsl:apply-templates select="messages" />

And these three lines...

<xsl:call-template name="topMenu">
    <xsl:with-param name="searchbox">true</xsl:with-param>
</xsl:call-template>

...must be also removed/commented and replaced by this one:

<xsl:apply-templates select="menu" />
 
Become a Bronze Member

Club Account



Join the SobiPro Club

New & Updated Apps...

SobiPro Full

SobiPro Full

Full installation package with sample data
SobiPro Clean

SobiPro Clean

Full installation package without sample data
Romanian Language

Romanian Language

Romanian Language Package for SobiPro (ro-RO)
Chinese Language

Chinese Language

Simplified Chinese Language Package for SobiPro (zh-CN)

Did you know...