Multi-Directory Component for Joomla!

SobiPro is the most advanced Multi-Directory Component for Joomla!
With only one SobiPro installation, you can build any kind of content on your website. It is flexible, fully customisable and mobile friendly.

Powerful search

The SobiPro Search is one of the features that make SobiPro a very powerful tool for site visitors. Almost each field can be configured to show up in the search form.

One for all

With SobiPro you can create as many directories and any other content types on your site as you need with only one single SobiPro component installation.

Responsive

Bring your directory with you on any device. Due to Bootstrap powered templates, you can show your content on any device out of the box

 

Information Center

The default Template - Template Settings

Template Settings

Last updated: 8. November 2017

Refers to version: 1.4.4+ (V4)

The default template included in SobiPro is a sophisticated template with a lot of features implemented, using a loop to show the fields defined in the fields manager. The most recent version of the default template is default4. The default4 template is based on Bootstrap 3.

Template Settings - Menu screenshot

Since version 1.2 of SobiPro, the SobiPro template comes with its own settings screen. You can reach these settings for one of your sections by navigating to SobiPro Control Panel and clicking on a section name from the sections list, or by selecting the section from the Sections drop-down button. Once the section opens, select the Section Template from the menu on the left and then click on Template Settings.

When saving the settings by clicking on Save on the upper right corner, the configuration will be saved, the LESS file(s) will be compiled and JSON files, containing the settings will be generated.

Please note that you need to have the PHP Phar extension installed on your server. Otherwise the LESS compiler does not work and as a result the template settings can't be saved!

General Settings

In this section you will find settings concerning the template as a whole.

Template Settings - General Settings screenshot

Template Style

The default template comes with the possibility to change the style of the template. This is the possibility to choose from different colour themes or to define a colour set, to change the style of the edges and of the top menu. In order that these changes take effect, SobiPro modifies the template file theme.less and compiles it.

DO NOT modify the file theme.less, otherwise the whole mechanism does not longer work!
If you need to make changes, make them in the file custom.less (formerly default.less), or if you do not want to use the LESS file, in custom.css (formerly default.css) only!

Colour theme
Template Settings - Colour theme screenshot There are several different colour themes available to choose from. They change the used colour for all elements on front-end. Use the theme custom to define your own colours.
Edge design
Template Settings - Edge design screenshot Select between angular and rounded to select angular or rounded elements on front-end.
Main background colour
Select the colour of the background of the SobiPro area. Ideally this is your Joomla template's background colour. Make sure that the selected colour fits to the selected colour theme.
Font colour
Select the colour of the main font for SobiPro. Ideally this is your Joomla template's font colour. Make sure that the selected colour fits to the selected colour theme.
Top Menu
Template Settings - Top Menu screenshot

Select between Standard Top Menu, Link Bar and Button Bar to select one of the different top menu styles.

Standard Top Menu:
Template Settings - Top Menu style: Standard Top Menu screenshot

Link Bar:
Template Settings - Top Menu style: Link Bar screenshot

Button Bar:
Template Settings - Top Menu style: Button Bar screenshot

Float Search/Add Buttons
Select between left and right to float the search and add button to the left or right. This setting is valid ONLY for the Top Menu option set to Button Bar!

Custom colours

When selecting custom from the Colour themes list, you can define your own colour set. Please see the documentation Create a custom colour set.

Template Settings - Custom colours Settings screenshot

Fonts

The used fonts can be changed to another font from a predefined list of Google fonts. The fonts will be loaded from Google CDN (Internet connection necessary).

Template Settings - Font Settings screenshot

Selecting a font does NOT change the font of non-SobiPro areas on your site!

Base font
The base font is the font, used for all texts in SobiPro elements. If you do not want to use a specific font in SobiPro, but the font inherit from your Joomla! template, select None (Joomla! template default). This is the default setting.
Base font size
Select the size of the base font. Use this setting to adapt the font size for SobiPro elements to your used Joomla! template.
SobiPro calculates the sizes for its different elements based on the base font size.
Font for Headings
Select a Google font used for SobiPro heading elements <h1>, <h2>, <h3> and <h4>. If you do not want to use a specific font for heading elements in SobiPro, but the font inherit from your Joomla! template, select None (Joomla! template default). This is the default setting.

Fonts information for nerds

You do not need to know the following information to use specific fonts for SobiPro! Nevertheless, if you experience problems with fonts, you may check it though.

To change the font size, there is support in the template needed as the font is changed by calling a few PHP function slocated in the template.

These PHP functions are available in the template's template.php file. For the default4 template these are the following functions:

public static function LoadFont ($name) {
  SPFactory::header()->addHeadLink("//fonts.googleapis.com/css?family=" . $name,"text/css", null,"stylesheet");
}
public static function ApplyBaseFont ($name) {
  SPFactory::header()->addCSSCode(".SobiPro.default4 {font-family:'". $name ."', sans serif;}");
}
public static function ApplyFont ($name) {
  SPFactory::header()->addCSSCode(".SobiPro.default4 h1,
                   .SobiPro.default4 h2,
                   .SobiPro.default4 h3,
                   .SobiPro.default4 h4 {font-family:'". $name ."', sans serif;}");
}

As you see, there is a template reference (default4) used in these functions. This is the template id as given in the file template.xml. If you copy the template using the integrated duplicate template function, SobiPro will change these references for you. If you copy the template manually, not using SobiPro, you need to change these references manually.

The call of these above mentioned functions is within the file common/topmenu.xsl as following:

<xsl:if test="//config/basefont/@value != 'none' and //config/basefont/@value != ''">
  <xsl:value-of select="php:function( 'tplDefault4::LoadFont', $basefont)"/>
  <xsl:value-of select="php:function( 'tplDefault4::ApplyBaseFont', $basefont)"/>
</xsl:if>
<xsl:variable name="specialfont"><xsl:value-of select="//config/specialfont/@value"/></xsl:variable>
<xsl:if test="$basefont != $specialfont and //config/specialfont/@value != '' and //config/specialfont/@value != 'none'">
  <xsl:value-of select="php:function( 'tplDefault4::LoadFont', $specialfont)"/>
  <xsl:value-of select="php:function( 'tplDefault4::ApplyFont', $specialfont)"/>
</xsl:if>

As you see, there is a template reference (tplDefault4) used in these functions. This is the name of the abstract PHP class in the file template.php. If you copy the template using the integrated duplicate template function, SobiPro will change these references for you. If you copy the template manually, not using SobiPro, you need to change these references manually.

Entry Form Settings

Template Settings - Entry Form Settings screenshot

Entry form class
At the moment only horizontal is available.
Add 'required' star
Adds a 'star' icon ( ) to the label if input is required.
Description position
You can choose how the text should be shown. The possibilities are below, above, on the right side and popup, where popup is the way older default templates used. Otherwise the text is shown below or above the input area.
Redirect to login page
If only registered users may add or edit an entry, the Add Entry button in the top menu is not visible for guests. If you want to have it visible, but redirects to a login page, enter the URL (relative or absolute) for that login page in this field. In this case the Add Entry button in the top menu is visible, but redirects to the login page or your site.

Search Form Settings

Template Settings - Search Form Settings screenshot

Extended search button
Show or hide the extended search button in the search form. The extended search button will be shown as soon as you select at least one field to be searchable not only via the general search input box. It is placed right of the Start Search button. If pressed, the additional search elements will be shown. If you have only one or a few additional search elements, it may be appropriate to show them all at once.
Please note, the search elements are always on top of the search results, so it is not advisable to hide the button if you have a lot of search elements.
Template Settings - Extended Search Button screenshot
Hide search parameters
If set to Yes, the search parameters are hidden after performing a search. A button Refine search parameters is available to open the search parameters again.

As this feature is meant for having a lot of extended search parameters shown (Extended search button is set to Hide), an additional button Start Search and a button Hide search parameters are shown below the extended search parameters.

Entries Settings

Find here settings for the entries in the different views.

Template Settings - Entries Settings screenshot

General Features

Settings for entries in vCard view (all listing views) and details view.

Show 'no image' placeholder
Template Settings - No Image Placeholder screenshot If an entry should have an image, but no image is uploaded, it is possible to show a 'no image' placeholder instead. Size and color of the placeholder depend on other settings (chosen colour theme, image ratio, ...). It has the same size as the vCard image resp. details view image (see below).
Placeholder ratio
The ratio of the placeholder. The following values are available:
  • 1:1
  • 4:3
  • 3:4
  • 9:6

Details View

Settings for entries in the details view.

Image width
The width of the image in the details view. Having a site responsive means, that the size of the image will be changed dynamically with the viewport size of the different devices. Hence it is necessary to upload a bigger image, otherwise the image may be blurred because it is shown in a bigger size than the upload settings of the image field allow. To reduce the size for specific views, as the details view, choose from an image size here. Select inherit if you want to use the settings from the image field. The following values are available:
  • inherit
  • 100px
  • 150px
  • 180px
  • 200px
  • 250px
  • 300px
  • 350px
  • 400px
  • 500px
Carousel image height
The image height of a carousel gallery if used. Specific SobiPro templates make use of this setting.

vCard

Settings for entries in the details view.

Image width
The width of the image in the details view. Having a site responsive means, that the size of the image will be changed dynamically with the viewport size of the different devices. Hence it is necessary to upload a bigger image, otherwise the image may be blurred because it is shown in a bigger size than the upload settings of the image field allow. To reduce the size for specific views, as the vCard (in all listing views), choose from an image size here. Select inherit if you want to use the settings from the image field. The following values are available:
  • inherit
  • 80px
  • 100px
  • 120px
  • 150px
  • 180px
  • 200px
  • 250px
Shorten text to
You can shorten the text of textarea fields if no WYSIWYG editor is used. For that, set the number of characters here and add the class shorten to the textarea general field setting CSS class.

This works only if NO WYSIWYG editor is used!

The following values are available:
  • No
  • 50 characters
  • 100 characters
  • 150 characters
  • 200 characters
  • 300 characters
  • 500 characters

View Settings

Settings for for different listing views.

View Features

Special features concerning all listing views.

Template Settings - View Features screenshot

Categories
Show or Hide. If Hide is selected, the categories list isn't shown by default and you will get a button to show and hide the categories container. If Show is selected, the categories list is shown always.
Count entries
Select if the number of entries in a category should be shown in brackets at the right side of the category name.
Pagination
Choose between Standard and Ajax. With Standard, you will get the standard pagination. Each new page reloads the whole side. With Ajax, you will get only a Read More button and the next entries are loaded below the previous ones without refreshing the page.

The standard pagination is active in background also if Ajax is selected and comes up if Ajax can't work due to an error.

Section View

Settings for the section view only. The section view is the main view of a section.

Template Settings - Section View screenshot

Entries per page
Number of entries (vCards) shown at once in the section view. If there are more entries available, the pagination is shown.
Entries per line
Number of entries (vCards) shown in one line.
Entries recursive
Show entries Yes or no entries No.
Entries ordering
Template Settings - Entries Ordering screenshot Select the ordering, the entries should be shown. Depending on the fields you have, the Fields orderings may differ.
Categories per line
Number of categories shown in one line.
Categories ordering
Template Settings - Categories Ordering screenshot Select the ordering, the categories should be shown.

Category View

Settings for the category views.

Template Settings - Category View screenshot

Fields Position
Determine where the category fields should be shown in the category view. Select between Above subcategories and entries, Between subcategories and entries and Below subcategories and entries.
Entries per page
Number of entries (vCards) shown at once in a category view. If there are more entries available, the pagination is shown.
Entries per line
Number of entries (vCards) shown in one line.
Entries recursive
Show also entries from sub-categories Yes or not No.
Entries ordering
Select the ordering, the entries should be shown. Depending on the fields you have, the Fields orderings may differ.
Categories per line
Number of categories shown in one line.
Categories ordering
Select the ordering, the categories should be shown.

Listing View

Settings for all other listing views (e.g. alpha view).

Template Settings - Listing View screenshot

Entries per page
Number of entries (vCards) shown at once in a listing view. If there are more entries available, the pagination is shown.
Entries per line
Number of entries (vCards) shown in one line.
Entries recursive
Show also entries from sub-categories Yes or not No.
Entries ordering
Select the ordering, the entries should be shown. Depending on the fields you have, the Fields orderings may differ.
Categories per line
Number of categories shown in one line.
Categories ordering
Select the ordering, the categories should be shown.

Deprecated Settings

Some entries settings render the same settings in SobiPro ➜ Section ConfigurationGeneral ConfigurationTemplateEntry Settings ineffective. These are the Entries ordering (Order by), Entries per page (Number per Page) and Entries per line (Number per Line). They will be removed in the next major version of SobiPro! They still exist for templates which does not have them in the template settings. If your SobiPro template does not have these settings, you need to contact your template developer and ask for an updated version.

Template Settings - Categories Ordering screenshot

Some categories settings render the same settings in SobiPro ➜ Section ConfigurationGeneral ConfigurationTemplateCategory Settings ineffective. These are the Categories ordering (Order by) and Categories per line (Number per Line). They will be removed in the next major version of SobiPro! They still exist for templates which does not have them in the template settings. If your SobiPro template does not have these settings, you need to contact your template developer and ask for an updated version.

Template Settings - Categories Ordering screenshot

RSS Feeds

These are the settings for the RSS feeds. The older method of an INI file in the folder feeds will be replaced by these template settings. The settings are written so the file rss.json. The following settings are valid only for the RSS template file feeds/rss.xsl If you rename it or add another one, you need to create the necessary JSON file manually.

By default RSS feeds are generated from section view and from category views.

Template Settings - RSS Feeds screenshot

Section View

No. of entries
The number of entries shown in the feeds.
Entries recursive
Show only entries from the main categories or also from sub-categories.
Entries ordering
Select from Newest first or Recently modified first.

Category View

Show feeds from
With implementation of the category fields, it can be useful to have RSS feeds for categories. Select if feeds should be shown from entries (default), categories or from both.

Settings for entries shown in the feeds:

No. of entries
The number of entries shown in the feeds.
Entries recursive
Show only entries from the main categories or also from sub-categories.
Entries ordering
Select from Newest first or Recently modified first.

Settings for categories shown in the feeds:

No. of categories
The number of categories shown in the feeds.
Categories ordering
Select from Newest first or Recently modified first.

Applications

There may be a tab Applications with settings from different applications.

Copyright (C) 2006-2017 Sigsiu.NET GmbH (https://www.sigsiu.net). All rights reserved.

This documentation and all images therein are copyrighted and protected by law. You may not publish, distribute or sell them or parts of it without explicit written permission of Sigsiu.NET GmbH.

Published on Wednesday, 23 December 2015.
Visited 3534 times.
Powered by SobiPro
to Top