Article tags

Article tags are a powerful feature to filter articles on a public website. In opposition to the image tags, which are used only for filtering in the admin area, the article tags are only displayed on the public website. Be careful, 'tags' are in the admin area not the same as 'categories' (although the tags appear on the public website under the headline 'Categories'), the term 'categories' in the Tiny Marbles CMS administration area are used for 'Article categories' by witch the navigation concept of a public website is setted up.

Attention: right now the feature of the tag filter on the public website doesn't support the MSSQL 2008 R2 or Express database. It is only tested with MySQL 5.x.

To 'tag' an article simple open an article, go to the tag box, and check an existing tag or add an a new tag and save the article:


The tags appear on the public website for instance like that (list on the right side with the header 'categories'):


Some rules for tags:

  • A tag is connected to the type of an article: either to the type 'Article, short' or 'Article, long'
  • Tags for 'Article, short' and 'Article, long' only appear on the public website with the scheme 'Flexible layout'
  • The scheme 'Horizontal tab system' only shows tags  for 'Article, long'
  • The scheme 'Financial' doesn't show any tags on the public website
  • Tags for 'Article, long' are connected to the chosen article category. This works best in case you have for instance a 'news list' like 'News and Infos' where you very often post new articles. With the help of 'tags' you can set filter for this article category
  • Tags for 'Article, short' are connected to the main article category in the main menu and to all categories underneath this article category. This works best in case you create for example a 'User guide', and underneath the user guide category you create a navigation tree where you connect many articles of the type 'Article, short'. In fact, this user guide is setted up exactly in this way.


Upload images

Uploading new images is very simple. You only have to follow the 3 steps, we describe on the screen: Choose an image from a directory, upload it and add the author, a description and a category. Now you can zoom, crop and rotate your new image.

Attention: the CMS-System only accepts GIF, PNG, JPEG or JPG files. The default type of the image after uploading is JPG unless the administrator chose PNG for the whole system at installation time. All images are converted automatically from the system to the chosen file type.




Right after all images were uploaded successfully click on 'Edit images' in the upload screen and the new images are shown in the image library.


Languages and translation

The language for the content of the website will be set in an article itself. The language is stored in the version of an article and each language has its own version control.

For the translation you first need to create an article in one language, let's say English. After saving the article you open the article again and change the language in the drop down menu for instance to 'German' and save the article again, as you can see in the screen below. Now you can manage both languages of an article independantly. You can filter the languages in the list of the versions of an article. If you delete an article, all its versions of all languages are deleted:



List articles

Click on 'List articles' on the main page of the Content Management area. You will get a list of all articles in the system with filter, sortable columns and pagination.

In the list of the articles you can see the columns 'Owner' and 'Author'. The 'Owner' of an article is the user who created the article, the 'Author' is the user who created a new version of an article.  


As you can see in the screen above you can filter from the article list the different languages and the different article types. In the list you have the information about the state of an article, which is very important for the publishing mechanism. The CMS provides the follwong states:

  • Online: an article is only 'Online', when the article is 'Published' and the current date is inside of the publish period.
  • Not published: the editor can set an article explicitely to 'Not published'
  • Offline: The current date is not in the publish period, that means, the public period already ended in the past or will start somewhere in the future

The 'Edit'-icon leads to the version list of an article. The icon 'loupe' shows a preview and finally the click on the icon 'trash can' deletes an article.

If you would like to delete one or more articles from the list, simply click on the trash can icons and collect the articles by using the control key or shift key of the keyboard. Then click on Delete? and the selected articles will be deleted after you confirmed a message from the system:



Article search

You can find the full text search for articles on the overview page of the tab 'Content Management'. Simply insert one or more search terms in the input field an click on the loupe icon. In case you enclose more than one search term in double quotes (for instance: "article search"), the search terms are combined with 'AND'. In that case only articles are shown in the search results, which contains all search terms inside the double quotes. A multiple search term without double quotes searches for articles which match to at least one of the single search terms:


After hitting the loupe icon, the list of the search results is shown. You can filter the search result using the filter: 'Language', 'Status', 'Type', 'Start date' and 'End date'. The 'Start date' and 'End date' filter are connected to the publish date of an article.:



Article layouts

The article layout determines how an article will apear in the public view part of the Tiny Marbles CMS. The layout follows the chosen scheme and the related CI (colors, graphics ..) for the complete website. Each layout is connected to an article category. What you usually do: you create an article category (see next chapter), there you specify the layout. Then you create an article which you assign to an article category. This is the common way how an article gets the layout and therefore the appearance in the public view part.


Right now Tiny Marbles CMS provides the following layouts:

  • Appointment
  • Article list, news
  • Article list, short
  • Article long
  • Article short
  • Blog
  • Contact
  • Dictionary
  • Google Maps
  • Team


Create a new article

Click on 'Create article' in the content management area or in the shortcut menu of the dashboard. First you have to specify the meta data of an article, which are common for all versions of an article. You can choose the publish and unpublish date (use the calendar icon), the language and the article type ('Article, short' or 'Article, long').  The author and the creation date are set automatically from the system. The article's state, which you can choose from a list box, can be 'Published' or 'Not published'. You can choose a title, but the title is not common for all versions, each version of an article gets its own title.


After you chose the article type the complete article appears according to the type. You can see one HTML-editor box for the type 'Article, short', and two HTML-editor boxes for the type 'Article, long'.

First you probably would like to select a category, for that you have to click on 'Add category'. On the right side the box with the category tree appears. You can only select categories which match to the type of the article. Simply click on the category of your choice and the article will apear later in this part of your website.


As you can see in the screen above the system autosaves the article automatically every 30 seconds. Furthermore you can click on 'Preview' to get the view of the page with the according layout (opens a new tab), or you can either 'Discard' or 'Save' the article. 

In case you click on 'Save article' the system automatically creates a new version of the article. On the first glance this might be inconvenient for you, but in practice this is a very relaxed way to work because you never have to think about versioning an article. You write your article, the autosave feature protects you against loosing content, and when you are finished simple click on 'Save article' to create the new version. 


List article versions

To get the list of all versions of an article click on the link 'All versions' in the list of articles. As a result page you get all available versions of an article.

Attention: Each time an article is edited and saved the system creates automatically a new version. As long as you work in the edit modus and the article is autosaved, only the first 'autosave'-operation creates a new version. The system uses always the information of the signed-in user and set his name in the field of the author:


For publishing an article you only have to choose the version you would like to publish and click on the 'publish'-icon. Only one version at the same time can be published: 




Using the HTML-editor

Now it is time to write the content. For that you use the HTML-editor boxes. The article type 'Article, short' provides one, the article type 'Article, long' two HTML-editor boxes. In case you have two boxes, the upper box will be used as a teaser in the website in case you are using a layout based on an article list, for example 'News'. The second box is the content area which appears on the website with the click on the link 'more'.


The HTML-editor offers the typical well-known text editing tools for e.g. underlining, bold typing or changing the font. Moreover, you can insert and edit images, written text and tables as well as Html code or embedded media (flash, quicktime, media player files). Please be careful in case you copy-paste text from other programs like for instance Microsoft Word. If you don't like to copy also the HTML information from the other systems use the folder symbol with the 'T' (in the sceen below marked with a red frame). The advantage is, that you only copy the pure text information and you avoid that your layout might be destroyed.