Simple:Press Documentation

Theme Changes 5.4.0 to 5.4.2

If you have created a custom theme then this will not be automatically updated when you upgrade Simple:Press to version 5.4.0. If you would like to take advantage of any new features that 5.4.0 through to 5.4.2 offers then these notes outline the main changes. These are based upon the Default theme. We recommend that you use an editor that has good file compare functionality so that you can easily see these changes in the Default theme and apply any desired changes to your own if you choose to do so.

Your theme should continue to work using Simple:Press 5.4.0 through to 5.4.2 without making any changes. Our goal has been not to disturb custom themes but sometimes this is beyond our control. Where this happen – or if you wish to take advantage of new features, some changes will be required.

Changes in version 5.4.0

spNewPostsView.php template text not translatable

The text string ‘Most recent topics with unread posts’ in the template spNewPostsView.php was not coded tp be properly translatable. This line of code

echo '
Most recent topics with unread posts
';

should be changed to:

echo '
'.__sp('Most recent topics with unread posts').'
';

jQuery ‘AutoComplete’ CSS Addition

A new CSS style has been added to ensure jQuery UI AutoComplete displays properly when used in a popup dialog, Add

.ui-front.ui-autocomplete {
    z-index: 101;
}

Changes in version 5.4.1

Counter ‘nowrap’ white-space rule in WordPress Themes

Oddly – we have encountered themes that set this by default on form buttons. To counter this on forum pages only – add the following new rule set to your Simple:Press theme:

#spMainContainer .spButton, #spMainContainer .spSubmit {
	white-space: normal;
}

‘Jumping’ Popup Windows

Under some WordPress themes and on some browsers, Simple:Press popup windows may sometimes jump down screen when attempting to drag them. This can be fixed using the following CSS rule change within your Simple:Press theme:

Locate the rule for the class ui-dialog
and change:

position: absolute;

to:

position: fixed !important;

Unified Theme only – Bold font-weight

To corrects an issue where ‘strong’ and ‘b’ html tags were being instructed to use a normal font weight the following new rule set has been added to the file base-reset.css in the styles folder of the theme:

#spMainContainer strong,
#spMainContainer b {
	font-weight: bold;
}

Changes in version 5.4.2

New Template Display Functions

The following new display functions have been introduced and made available for use.

sp_ForumIndexSubscriptionIcon()

Note: This new function is a component of the Simple:Press Subscriptions plugin.
It can be used for displaying the ‘subscribe to forum’ icon against each forum in Group View. In most themes, this icon is usually displayed as a part of the status icons set but the Unifiedtheme utilises individual functions for each icon and this adds to that capability. Default usage would be:

if(function_exists('sp_ForumIndexSubscriptionIcon')) sp_ForumIndexSubscriptionIcon('tagClass=spIcon spRight', __sp('Subscribe to this forum'), __sp('Unsubscribe from this forum'));

sp_PostIndexMyCred()

Note: This new function is a component of the new Simple:Press MyCred Extended Integration plugin.
It can be used for displaying a users MyCred ‘points’ in the user section of each topic post. Typical usage would be:

if(function_exists('sp_PostIndexMyCred')) sp_PostIndexMyCred('tagClass=spPostUserMyCred spCenter', __sp('MyCred '), __sp('MyCred'));

Note: A new sp-mycred.css file has been added to the Unified theme styles folder.

sp_ForumIndexDeniedIcon()

Note: This new function is for use by the Simple:Press Unified theme only.
This new function will correctly show the new Write Denied status icon when using the Unified theme or a custom theme derived from it. This can be used in the Group View template and a typical usage would be:

sp_ForumIndexDeniedIcon('tagClass=spIcon spRight', __sp('No permission to start topics'));

sp_OpenCloseControl()

This function is a general control function that allows for sections of the forum to be opened and closed using Ajax calls. It is primarily available for use by theme authors.

Changes to Template Display Functions

sp_TopicIndexPageLinks()

A new optional parameter has been added to the end of the sp_TopicIndexPageLinks() template display function to add a tooltip for the new ‘jump to page’ icon.

sp_PostIndexPageLinks()

A new optional parameter has been added to the end of the sp_PostIndexPageLinks() template display function to add a tooltip for the new ‘jump to page’ icon.

sp_ForumIndexSubForums()

A new argument has been made available to the sp_ForumIndexSubForums() template function (Group View) to determine the size of the sub-forum icons if custom icons are being used. The new argument is named ‘iconWidth‘ which is set by default to a value of 20.

sp_ForumIndexStatusIcons()

To display the new Write Denied status icon the Group View template display function sp_ForumIndexStatusIcons() has been given 2 new arguments and an extra parameter. These are:

Argument: iconDenied The name of the preferred icon if not using the default (see below for new icon section)
Argument: showDenied Switch (1 or 0) on whether to didsplkat the icon or not – default is true (1)
Parameter: toolTipDenied Text of the icon tooltip. If no tooltip text is used then the icon will NOT display

sp_TopicNewButton() and sp_TopicIndexStatusIcons()

To display the new Write Denied status icon the Forum View template display functions sp_TopicNewButton() and sp_TopicIndexStatusIcons() have been given 1 new argument and an extra parameter. These are:

Argument: iconDenied The name of the preferred icon if not using the default (see below for new icon section)
Parameter: toolTipDenied Text of the icon tooltip. If no tooltip text is used then the icon will NOT display

sp_PostNewButton()

To display the new Write Denied status icon the Topic View template display function sp_PostNewButton() has been given 1 new argument and an extra parameter. These are:

Argument: iconDenied The name of the preferred icon if not using the default (see below for new icon section)
Parameter: toolTipDenied Text of the icon tooltip. If no tooltip text is used then the icon will NOT display

Changes to Theme Templates

searchScope

All themes have been modified to add a new search form argument for searchScope. All themes default the searchScope to 1 which keeps the default to current forum (if on forum/topic page). A value of 2 will always set it to all forums. To add this value..

The template to edit is the spHead.php template. Locate the search form argument defintion block captioned:
Search FORM – OBJECT DEFINITION
and add the following to the bottom of the list:

'searchScope' => 1,  # 1 = Current Forum, 2 = All Forums

Unified Theme Only (Desktop View) – Minor Button Alignment

To correct slight misalignment of Group View RSS button and the Open/Close button in Desktop View the arguments to the display function sp_GroupHeaderRSSButton() now include class directives for the icon display so the default is now:

sp_GroupHeaderRSSButton('tagClass=spLink spRight&iconClass=spIcon spRight', '', __sp('Subscribe to the RSS feed for this forum group'));

New Icons

There are 2 new icons ontroduced in this release. Both must reside in the images folder of your Simple:Press theme. They are:

sp_Jump.png New image for Forum/Topic View ‘jump to page’ icon
sp_WriteDenied.png New image to show that the user has no write access
NOTE: The Unified has two versions of an icon – one in the images folder for desktop use and one in images/mobile folder for mobile phone display

Changes to CSS Styling – All Themes

The following style changes apply to all current Simple:Press themes. However, if you are using a custom theme derived from our Unified, then please note there may be separate directives plus a second section that applies to Unified only.

WordPress Dialog Popup

Further changes in the base WordPress CSS in WP 3.9.0 have resulted in some minor changes being needed for the ui-dialog classes. These are:

Locate the rule for the class:

.ui-dialog

and remove the z-index property.
Locate the rule for the class:

.ui-dialog .ui-dialog-title

and add the following two properties:

line-height: 18px;
font-size: 16px;

Finally add this new rule within the ui-dialog section:

.ui-dialog .ui-dialog-titlebar-close:before {
	content: " ";
}

If Unified then add this new rule:

.ui-dialog-content {
	padding: 2px;
}

On-line Users

To prevent new on-line user display names from being bolded if not linked to a profile – add the new rule:

#spMainContainer .spCurrentOnline span.spOnlineUser {
	font-weight: normal;
}

Search Link Labels

The margin rule of the search link labels has been changed for improved styling capability.

Locate the rule for the class:

#spMainContainer .spSearchForm a

and replace the two properties:

margin-left: 5px;
margin-top: 0;

(Unified only) with the single property:

margin: 4px 5px 0 5px;

and all other themes with the single property:

margin: 0 5px;

Changes to CSS Styling – Unified Only

The following CSS rule changes only apply to the Unified theme or custom themes derived from Unified.

New ‘Go To Page’ Control

Locate the section

@media screen and (max-width: 640px)

and within that @media rule block add the new rule set:

#spMainContainer .spPageJump img.spIcon {
	max-width: <?php echo($iconWidth); ?> !important;
	max-height: <?php echo($iconHeight); ?> !important;
}

Mobile Select List Controls

To correct an anomaly in select list control styling

Locate the rule set:

#spMainContainer .spOptionsList

and add two new properties:

border: <?php echo($controlBorder); ?>;
<?php echo($smallRadius); ?>

On-line User Font Weight

Locate the rule set:

#spMainContainer .spCurrentOnline span.spOnlineUser

and change the font-weight rule from using the variable:

$mainFontWeight

to the variable:

$headingFontWeight

Breadcrumbs – Font Sizing

To correct an issue where the font size of the breadcrumbs cannot easily be changed:

Locate the rule set:

#spMainContainer #spBreadCrumbs

and remove the property:

font-size: <?php echo($breadCrumbsFontSize); ?>;

and then locate the rule set:

#spMainContainer #spBreadCrumbs a

and add the property there:

font-size: <?php echo($breadCrumbsFontSize); ?>;

The ‘Midnight Overlay

To correct an error in the Unified theme Midnight overlay where the statistics section displayed white text on a while background:

Locate the variable definition:

$statsSectionBackGround

and change the value ‘transparent‘ to the variable:

$baseColor3


Copyright © 2006-2019 Simple:Press. All Rights Reserved.