Understanding Tags and Widgets

May 26, 2014 4:08 pm

The term "tags" is a term used in many different ways when it comes to websites and CMS systems. In the past, Accrisoft Freedom called many of the insertable formats "tags" and this caused some confusion. Now, the term "tags" is only used to refer to the ability to tag an item for searching and indexing on a site. For example, you might tag a blog entry with the tags: marketing, SEO, and branding.

Now, what used to be termed tags are referred to more by their actual purpose, which is usually to insert a bit of code, html, or formatting into a section of an Accrisoft Freedom website. The format for all of these is to surround the insertable code in double brackets before and after the code. The format also includes a prefix that specifies what type of item you are inserting, followed by a period, followed by the unique name of the format. For example:

[[page.Home]]

There are three main types of these insertable sections of code, which are used primarily in the Layouts module of the Green interface. These include:

Page layouts - [[page.Header]]

Module layouts - [[layout.events_side]]

Widgets - [[widget.date]]

Page layouts let you insert a section html coding into another section. These page layouts are all created on the Pages tab of the Layouts module. Usually, page layouts store the frame and static html and css for sections of the website. This code can contain all the html and css of a page of the site or just a section of code that you can insert in other places. For example, you might have the same section of html code that appears at the bottom of every page of the site, while other sections might change from page to page. You could create a page layout named Footer that you can insert on every page layout of the site to make it easy to update the footer coding at one time. Note that you cannot link directly to a page layout other than the home or landing page of a site. You must link to content that uses that page layout.

Module layouts let you insert special html and other formatting for a specific module into another section. These module layouts are all created and managed on the Modules tab of the Layouts module. Each module may have different layout formats that depend on the module. For example, the Events module has layouts for a list of events, single event details, mini-calendar, and full calendar while the News module only has the list and detail layouts. You can link to module layouts that show lists of items, but you cannot link directly to a detail layout without first linking to a specific content item.

Widget layouts let you insert special features and formats into a section of the site. Usually, these widgets have just a few configuration settings when you set them up, but no html that is configuable as part of the widget. These widgets are all created and managed on the Widgest tab of the Layouts module. Each widget may have very different configuration settings. Examples of widgets include a date widget to insert the current date into a page layout, banner add widget to insert a banner add group from the Banner Ads module in the Blue interface, or the Print widget to add a link to print the current page of the site.