Welcome Guest! Login
0 items Join Now

Topaz: BookBlock Particle

Your Guide to Recreating Elements of the Topaz Demo for Joomla


The BookBlock particle enables you to present content in a way that mimics a book, with its own page turning animation and plenty of room for written and visual content.

Here are the topics covered in this guide:


BookBlock items have a simple, yet robust layout that enables you to add a lot of different types of content in a single item. Each item spans both sides - or pages if you prefer - of the particle's layout. There is, of course, a difference in how this content is sourced depending on whether you are using items created in the particle's settings panel, or from the CMS.

Particle Content

Item - Category
Item - Intro
Item - Content
Item - Read More Label
Item - Image
Item - Image Title
Item - Image Description
Item - Name

One important thing to note when using Particle as the Content Source is that the name of the item becomes the big title you see in the upper-left area of the particle on the front end. This is in contrast to most particles where the name is a simple reference you only see on the back end.

The rest of this content is set up as an item. Items can be added in the Block section of the particle's settings panel. Find out more about item settings for this particle here.

CMS Content

Article - Joomla Category
Article - Article Intro Text
Article - Article Content
Article - Read More Label
Article - Intro Image
Article - Intro Image Alt Text
Article - Intro Image Caption
Article - Title

When Joomla is selected as the Content Source, the article's title becomes the big title in the upper-left area of the particle. The text under the image to the right is made up of the Alt Text and Image Caption for the Intro Image that is assigned to the article.


Main Options

Option Description
CSS Classes Sets the CSS class for the content of the particle.
Content Source Select Particle or Joomla to determine where particle content is pulled from.
Title Sets the title of the particle, as it will appear on the front end.

Item Options

These items only appear on the front end if you select Particle as the Content Source.

Option Description
Category Enter the category you would like to appear in the particle.
Intro Enter the introductory text you would like to appear in the particle.
Content Enter the content you would like to appear in the particle.
Read More Label Enter the text you would like to have link to the link you set in the Read More Link field.
Image Select the image you would like to have appear on the right side of the particle.
Image Title Enter a title for the image. This appears below the image.
Image Description Enter a description for the image. This appears right below the title under the image.
Particle Name Enter a name for the item. This name appears on the front end.

CMS Options

These options are only useful if you select Joomla as the Content Source.

Option Description
Joomla Categories Enter the categorie(s) you would like to appear in the particle.
Articles to Fetch Enter the number of articles you would like to have loaded in the particle.
Intro Image Enable or disable the intro image appearing in the particle.
Categories Names Enable or disable the category of the article in the particle.
Article Title Enable or disable the title of the article appearing in the particle.
Intro Text Enable or disable the Intro Text appearing under the image in the particle.
Link Enable or disable the read more link.
Link Text Enter the text you would like to appear in the Read More link.

Found errors? Think you can improve this documentation? Please edit this page. You can also view the history of this page.