ABOUT...

Custom blocks, 2.5.2
© 2013-2020 by davidhs
© Polish language 2014-2018 by FishingManMatt


This work is licensed under a Creative Commons Attribution 3.0 Unported License.

DESCRIPTION

Allows to show custom blocks:

• Forum header:
  
  
     
  • Above the forum header.
  • Instead of default header of forum.
  • Below the forum header.
• Forum menu:
  
  
     
  • Instead of the forum menu.
• Message index:
  
  
     
  • Above the child boards of the message index.
  • Above the messages of the message index.
  • Below the messages of the message index.
• Forum footer:
  
  
     
  • Above the forum footer.
  • Instead of default footer of forum.
  • Below the forum footer.

Can be define any number of blocks through several parameters:

• Frame: HTML code with attributes for DIV tag which skirts the content of the block. If left empty is not put DIV tag. Through style or class attributes (CSS styles and classes) may indicate position, size and others characteristics of the block.
• Type: A block can contain HTML code (the default option), BBC or PHP.
• Content: Content of the block. Position, size and others characteristics of the block may be indicated here or in frame. Can be used the following variables:
  
  
  
  • {BOARDURL} - URL to forum folder.
  • {SCRIPTURL} - Web address of forum.
  • {IMAGES_URL} - URL to the images folder in the users current theme.
  • {DEFAULT_IMAGES_URL} - URL to the images folder in the default theme.
  • {MENU} - Forum menu. Can be used only in blocks of the forum header, menu or footer. If it is not found, a block with the text of menu will be created in forum menu area.
  • {COPYRIGHT} - Copyright of the forum. Can be used only in blocks of the forum header, menu or footer. If it is not found, a block with the text of copyright will be created in forum footer area.
  • {ID_BOARD} - ID of the board. Can be used only in blocks of the message index.
• Order: Position of the block in relation to the other blocks from left to right.
• Permissions: Indicates the user group that can see the block. By default none.
• Active: Indicates if a block is active. By default active.

EXAMPLE

QuoteBlocks above the forum header

---

Frame: style="height: 50px; border: 5px solid red;"
Type: BBC
Content: [size=12pt]Block above the header[/size] [color=red]- Block above the header - Block above the header[/color]
Order: 1
Permissions: Guest:View, User:View, Local moderator:View, Global moderator:View, Administrator:View
Active: Yes

---

Blocks in the forum header

---

Frame: style="float: left; width: 250px; height: 50px; border: 5px solid red;"
Type: HTML
Content: <span style="font-size: 12pt;">Block header 1</span> <span style="color: red;">- Block header 1 - Block header 1</span>
Order: 1
Permissions: User:View, Local moderator:View, Global moderator:View, Administrator:View
Active: Yes

---

Frame: style="float: left; width: 10%; height: 50px; border: 5px solid red;"
Type: BBC
Content: [size=12pt]Block header 2[/size] [color=red]- Block header 2[/color]
Order: 2
Permissions: User:View, Local moderator:View, Global moderator:View, Administrator:View
Active: Yes

---

Frame: style="float: center; height: 50px; border: 5px solid red;"
Type: PHP
Content: $bl = 'Block header 3';
echo '<span style="font-size: 12pt;">', $bl, '</span> <span style="color: red;">- ', $bl, ' - ', $bl, '</span>';
Order: 4
Permissions: User:View, Local moderator:View, Global moderator:View, Administrator:View
Active: Yes

---

Frame: style="float: right; width: 150px; height: 50px; border: 5px solid red;"
Type: BBC
Content: [size=12pt]Block header 4[/size] [color=red]- Block header 4[/color]
Order: 3
Permissions: User:View, Local moderator:View, Global moderator:View, Administrator:View
Active: Yes

---

Frame: style="height: 50px; border: 5px solid red;"
Type: BBC
Content: [size=12pt]Block header guest[/size] [color=red]- Block header guest - Block header guest[/color]
Order: 1
Permissions: Guest:View
Active: Yes

---

Blocks below the forum header

---

Frame: style="height: 50px; border: 5px solid red;"
Type: BBC
Content: [size=12pt]Block below the header[/size] [color=red]- Block below the header - Block below the header[/color]
Order: 1
Permissions: Guest:View, User:View, Local moderator:View, Global moderator:View, Administrator:View
Active: Yes

---

Blocks above the forum footer

---

Frame: style="height: 50px; border: 5px solid red;"
Type: BBC
Content: [size=12pt]Block above the footer[/size] [color=red]- Block above the footer - Block above the footer[/color]
Order: 1
Permissions: Guest:View, User:View, Local moderator:View, Global moderator:View, Administrator:View
Active: Yes

---

Blocks in the forum footer

---

Frame: style="float: left; width: 33%; height: 50px; border: 5px solid red;"
Type: HTML
Content: <span style="font-size: 12pt;">Block footer all</span> <span style="color: red;">- Block footer all - Block footer all</span>
Order: 1
Permissions: Guest:View, User:View, Local moderator:View, Global moderator:View, Administrator:View
Active: Yes

---

Frame: style="float: right; width: 50%; height: 50px; border: 5px solid red;"
Type: BBC
Content: [size=12pt]Block footer user[/size] [color=red]- Block footer user - Block footer user[/color]
{COPYRIGHT}
Order: 2
Permissions: User:View, Local moderator:View, Global moderator:View, Administrator:View
Active: Yes

---

Frame: style="float: right; width: 200px; height: 50px; border: 5px solid red;"
Type: PHP
Content: $bl = 'Block footer guest';
echo '<span style="font-size: 12pt;">', $bl, '</span> <span style="color: red;">- ', $bl, ' - ', $bl, '</span>';
Order: 2
Permissions: Guest:View
Active: Yes

---

Blocks below the forum footer

---

Frame: style="height: 50px; border: 5px solid red;"
Type: BBC
Content: [size=12pt]Block below the footer[/size] [color=red]- Block below the footer - Block below the footer[/color]
Order: 1
Permissions: Guest:View, User:View, Local moderator:View, Global moderator:View, Administrator:View
Active: Yes

Users, moderators and administrators see this:

Guests see this:

SMF COMPATIBILITY

• SMF 1.1 to 1.1.21.
• SMF 2.0 to 2.0.17.
• SMF 2.1 Beta 3 and RC1 to RC2.

This MOD is installed without errors in default theme and similars. For others themes is necessary to make changes at hand:

• Actualism, 2.0.4.
• Core Theme, 2.0.
• Immortality, 2.0.2.
• Reseller, 2.0.8.
• Thing, 2.0.

LANGUAGES

• english, english_british.
• polish.
• spanish (SMF 1.1.x), spanish_es, spanish_latin.

DOWNLOAD

Link to MOD

MANUAL INSTALLATION

See https://wiki.simplemachines.org/smf/Manual_installation_of_mods

COLLABORATE WITH THIS MOD

This work is licensed under a Creative Commons Attribution 3.0 Unported License.

You are free to share and adapt this MOD. Also you can collaborate in different ways:

• Translate the mod into other languages, adding the translation in https://www.simplemachines.org/community/index.php?topic=506711.0.
• Write comments, detect errors or suggest improvements in support topics
  in English https://www.simplemachines.org/community/index.php?topic=506711.0 and
  in Spanish https://www.simplemachines.org/community/index.php?topic=503400.0.
• Help to expand my collection of coins, banknotes and stamps, sending me something from your country via postal mail (ask me for address by personal message).
• Make a donation via PayPal.

CHANGE LOG

Legend:   ! Fixed   + Added   - Removed   * Changed   @ Note

2.5.2   2019-05-05
------------------
! SMF 2.1.x: Use HTML 5.
! SMF 2.x: The Quick Search of the Administration Center look for in settings variables of MOD.
+ SMF compatibility: 2.1 RC1 to RC2.

2.5.1   2018-12-06
------------------
! SMF 2.1.x: logAction is a deprecated function. Instead, logActions is used.
! Quick Edit and Insert Quote buttons did not work.
! Languages: Some language string in polish, polish-utf8.
+ Languages: New language string in polish, polish-utf8, thanks to FishingManMatt.

2.5     2018-08-12
------------------
! SMF 1.1.x: Theme of the generic form of displaying lists.
+ Upgrade code to the configuration variables from versions 2.3-2.4 to 2.5.
+ SMF 2.1.x: Uninstallation code to the configuration variables.
* In Administration panel, custom blocks are grouped by their position.
+ Custom blocks instead of the forum menu.
+ Custom blocks instead of the message index: Above the child boards, above the messages and below the messages.
* The variable to insert the copyright can be included in any block of the forum header, menu or footer.
+ Variable in content of a block of the forum header, menu or footer to insert the forum menu.
+ Variable in content of a block of the message index to insert the ID of the board.
+ Actions of Administration panel are logged to Administration log.
@ Administration log does not exists in SMF 1.1.x.
+ SMF compatibility: 2.0.11 to 2.0.15 and 2.1 Beta 3.
- SMF 2.0.x: Languages: spanish, spanish-utf8 (these are not used).
+ Languages: New language string in polish, polish-utf8, thanks to FishingManMatt.

2.4     2015-05-15
------------------
+ Field in administration panel to edit the position of the block.
+ SMF compatibility: 1.1.21 and 2.0.10.
+ Languages: polish, polish-utf8, thanks to FishingManMatt.

2.3.2   2014-10-08
------------------
+ SMF 1.1.x: Implemented a generic form of displaying lists, similar to SMF 2.0.x.
+ SMF compatibility: 1.1.20 and 2.0.9.

2.3.1   2014-06-24
------------------
! Use HTML entities in ISO-8859-1 languages.
+ Functions to get/update/delete data check the parameters before using them.
* Big multi-line text input fields are wider.
* Submit buttons have shortcut key to get focus.
+ SMF compatibility: 2.0.8.

2.3     2014-01-25
------------------
+ Upgrade code to the configuration variables from versions 2.1-2.2 to 2.3.
* Permissions for local moderator and global moderator instead of moderator.
+ Checkbox to select all users of permissions.
+ SMF compatibility: 2.0.7.

2.2     2013-12-20
------------------
! SMF 2.0.x: Functions of administration area must return settings variables for the Quick Search of the Administration Center.
+ SMF 2.0.x: The Quick Search of the Administration Center look for in settings variables of MOD.
+ Variable in content of the block to insert URL to forum folder.

2.1     2013-11-02
------------------
! There was a PHP error when the list of blocks was empty.
! Error in source code.
+ Upgrade code to the configuration variables from version 2.0.x to 2.1.
+ Field to indicate if a block is active.
+ Custom blocks above and below the forum header and above and below the forum footer.

2.0     2013-10-23
------------------
! SMF 2.0.x: Integration hooks functions parameters must be passed by reference.
! If user does not have permission to view any block of forum header (or footer), default forum header (or footer) must be displayed.
+ Upgrade code to the configuration variables from version 1.x to 2.0.
+ Variable in content of the block to insert web address of forum.
+ Variable in content of the block to insert url to the images folder in the users current theme.
+ Variable in content of the block to insert url to the images folder in the default theme.
* Permissions for user, moderator and administrator instead of user (not guest).
+ Parameter frame of block, where writing the block border characteristics.
+ SMF compatibility: 1.1.19, 2.0.5 and 2.0.6.

1.0     2013-05-06
------------------
@ This work is licensed under a Creative Commons Attribution 3.0 Unported License https://creativecommons.org/licenses/by/3.0/
+ Custom blocks instead of default header and footer of forum.
+ Administration panel.
+ SMF compatibility: 1.1 to 1.1.18.
+ SMF compatibility: 2.0 to 2.0.4.
+ Languages: english, english-utf8, spanish_es, spanish_es-utf8, spanish_latin, spanish_latin-utf8.

CustomBlocks_1.0.tar.gz 8.14 KB

CustomBlocks_2.0.tar.gz 16.83 KB

CustomBlocks_2.1.tar.gz 18.78 KB

CustomBlocks_2.2.tar.gz 19.05 KB

CustomBlocks_2.3.tar.gz 19.56 KB

CustomBlocks_2.3.1.tar.gz 19.88 KB

CustomBlocks_2.3.2.tar.gz 20.13 KB

CustomBlocks_2.4.tar.gz 22.41 KB

CustomBlocks_2.5.tar.gz 32.19 KB

CustomBlocks_2.5.1.tar.gz 30.06 KB

CustomBlocks_2.5.2.tar.gz 34.03 KB

Manual installation info 1.1.18 1.1.19 1.1.20 1.1.21 2.0.4 2.0.6 2.0.7 2.0.8 2.0.9 2.0.10 2.0.11 2.0.12 2.0.13 2.0.15 2.0.17 2.1 Beta 3 2.1 RC2