Taxonomies and Tags support for Joomla

From Walter Cedric Wiki
Jump to: navigation, search

Joomla cedtag moreThemes.png

Compatible with Joomla 1.5 and Joomla 2.5 Compat 15 native.png Compat 25.png

Contents

Introduction

cedTag is a powerful Joomla extension, gives your sites use of the organizational keywords known in other systems as categories, tags, or metadata. Taxonomy is the practice of classifying content. It will come in handy for everything from menu and navigation schemes to view and display options. Taxonomy is the practice of classifying things. In this extension, the Taxonomy module is how you classify your website content, and it is an important piece of many sites' information architecture. It's helpful to think of taxonomy as the use of "categories". Taxonomy lets you gather together content under one term or another. It has become advanced enough to give you as much flexibility as you need in designing classification schemes.


To Resume: Tags provide a useful way to group related posts together and to quickly tell readers what a post is about. Tags also make it easier for people to find your content. Tags are similar to, but more specific than, categories.

CedTag history

CedTag admin ui

CedTag is the continuation of the GPL component Joomla Tags (www.joomlatags.org), Most of the code has been rewritten according to the new standard of Joomla 2.5, the component has been greatly extended and most bugs have been removed. I will continue removing, refactoring existing codebase, in order to be able to add new features faster.

It do not present any risks, do not touch Joomla content (except the export function of tags to Joomla META-KEYS) and should be safe to use. I am the author and use it at http://www.waltercedric.com

Update will NEVER remove your existing tags


Major features

CedTag displays a list of tags in what is called a 'tag cloud', where the size of each tag is determined by how many times that particular tag has been assigned to posts.

Additionally, it is possible to sort tags by count and alphabetically at the same time. It is also possible to add a counter to the tags, so that your visitors can see how many posts are associated with each tag. The plugin also adds a sensible CSS class to every tag.


Unique features

  • Tags autocompletion using ajax in both front end and backend: search, add and delete of tags!
  • Support 501 Google web fonts! (see screenshots)
  • All in one install: 1 components, 5 modules and 4 plugins!
  • Stop Words support: some tags do not appear as Terms because they are either insignificant (i.e., articles, prepositions) or common. Filtering can now be now be switched off. 600 Words in English and 950 in German are part of the extension. More than 600 stop words in English and 950 word in German that are filtered out from being tags out of the box. You can also edit these list and add your own set of words
  • Support Joomla 2.5 ACL. All operations are restricted for the logged in user. Due to the nature of ACL, some part of the control may not be displayed because you lack the permission to create, edit or delete content


Front end

  • Show tags at the bottom of each article,
  • Automatically add tags based on Joomla Meta Keys after an article save,
  • Tag list view
  • Tag blog view
  • Add/Edit Tags
  • Language File
  • Google Web Fonts support

Menu linkable

  • view where all tags are displayed

Modules

  • Most popular tags cloud,
  • Most hits tags cloud,
  • Most Read tags could,
  • Latest tags,
  • Random tags cloud,
  • HTML5 animated tagcloud output for all modules

Ajax tags entry

  • Convenient way for users to enter a list of items
  • Fully integrated with jQuery ui auto complete
  • Automatically adds current input as tag if input loses focus
  • Easy to theme (single css file)
  • Customizable accept keys
  • Backspace on empty input deletes previous tag
  • Ability to sort tags via drag and drop!


Administrator features

  • Import Tags from Meta keywords.
  • Term editable.
  • Batch term add.
  • Batch tag management.
  • Css file online edit.
  • Language File
  • unwanted words also named StopWords are supported in English and German

Installation

Install the package like any package using the Joomla installer. A successful install must display something like this

The installation process do not create default modules for you, you have to go to the module manager, and click new to create the 5 different modules available

  • Module Latest Tags
  • Module Popular Tags
  • Module Random Tags
  • Module Custom Tags
  • Module Most Read Tags

Usage (Quick)

If you have properly configured and add carefully Joomla content Meta Keys, you can safely import all these words as tags: you will get as many tags as there is different Meta Keys. Use the import function.


Frontend

Modules

The installation process do not create default modules for you, you have to go to the module manager, and click new to create the 5 different modules available

  • Module Latest Tags will show the latest tags.
  • Module Popular Tags will show tags which have most articles.
  • Module Random Tags
  • Module Custom Tags
  • Module Most Read Tags will show most read tags.

Display tag in frontpage

You can display tags also in frontpage. There is 3 modes

  • display below the title
  • display after the fulltext
  • display at both position

Display tag when viev in article

Enter tags

You can add tags one at a time by hitting the Enter/Return key on your keyboard after typing each tag. Or you can add multiple tags at a time by separating them with a comma as you type.

  • Only work if you are logged in in frontend as an Editor/Administrator.
  • Full support of tags autocompletion using ajax: search, add and delete of tags!

CedTag supportTagsWithSpace.png

Remove tags

To remove a tag from the post, click the small X icon next to the tag.

Special Menu entries

Wordle menu entry

Wordle is a toy for generating “word clouds” from text that you provide. The clouds give greater prominence to words that appear more frequently in the source text. You can tweak your clouds with different fonts, layouts, and color schemes.

To use it, go to the main menu for example and hit "new" (menu entry), under the button "select" and in the popup "Select a Menu Item Type:" the choice wordle will appear.

Set the option to your liking and enjoy the result in the frontend

CedTagWordle.png

All Tags menu entry

To display all tags on one page for a better SEO, you can create a menu entry that point to /index.php?option=com_cedtag&view=alltags or click on new menu entry

Special Pages / error handling

Warning page: tag xxx do not exist

Warning page for tag that do not exist, configurable if you prefer an error 404 instead (default: warning page). Text can be changed in \language\en-GB\en-GB.com_cedtag.ini and view can be adapted to your preferences at /components/com_cedtag/views/tag/tmpl/requested_tag_do_not_exist.php

Warning page: tag having no articles

Warning page for Tag that have no articles. Text can be changed in \language\en-GB\en-GB.com_cedtag.ini and view can be adapted to your preferences at /components/com_cedtag/views/tag/tmpl/no_articles_with_tag.php

Backend

CedTag admin ui

The backend panel consist of

  • Articles Manager
  • Tags Manager
  • Configuration
  • Template Manager
  • Stop Words
  • Import Tags
  • Export Tags
  • Maintenance
  • Statistics
  • Home page (link)
  • Manual (link)
  • Forums (link)
  • License (link)
  • Skype Me (link)
  • JED Vote (link)
  • Download latest(link)

....

Articles Manager

functionalities

  • Selecting existing tags / adding new tags / removing tags, Tips: copy and paste a list of comma separated tags is supported!
  • Searching for articles using "Article Filter"
  • Searching all articles which are tagged with xxxx
  • Displaying articles from specific categories/author/language
  • Paging is supported


Adding Tag to articles

  • You can use the Tag Manager to search for specific articles, and add multiple term using a responsive search that use ajax.
  • You can Cut and Paste a list of tags (seaparated by comma) in a field


CedTag TermManager1.png

notes

  • Terms that are not published will be never displayed here or after hitting save.
  • New Terms that are not existing will be automatically created.

Tags Manager

functionalities


Entering descriptions of Terms

Description – Describes what the tag is for. This may be displayed in certain themes as, for example, a tooltip (shown when you hover over the tag).


Note that

  • the system cedTag can auto-complete the tag descriptions with Wikipedia OpenSearch API!
  • Support more than 40 localized Wikipedia servers (all Wikipedia with more than 100’000 articles)
    • العربية • Български • Català • Česky • Dansk • Deutsch • English • Español • Esperanto • Euskara • فارسی • Français • 한국어 • हिन्दी • Hrvatski • Bahasa Indonesia • Italiano • עברית • Lietuvių • Magyar • Bahasa Melayu • Nederlands • 日本語 • Norsk (bokmål) • Polski • Português •Қазақша / Qazaqşa / قازاقشا • Română • Русский • Slovenčina • Slovenščina • Српски / Srpski • Suomi • Svenska • Türkçe • Українська • Tiếng Việt • Volapük • Winaray • 中文

In Terms Manager

File:Cedtag wikipediaautofill1.png File:Cedtag wikipediaautofill2.png

When editing a Term

File:Cedtag wikipediaautofill3.png


Bulk Actions

If you have a lot of tags that you want to delete, you can use the bulk actions feature. Select each tag you want to delete using the checkbox to the left of the tag name.

Configuration

Using Google Fonts

Hundreds of free, open-source fonts optimized for the web. see http://www.google.com/webfonts

You can change fonts under "Configuration" tab "Fonts".

Limitations

Number of supported fonts

The extension can not support the currently growing list of 501 fonts provided by the Google Web Font services (http://www.google.com/webfonts) If you want to use a font not provided as a choice by the component, either

  • Drop me an email with the font name or url you would like to have using the contact section http://www.waltercedric.com/contacts
  • you edit the file config.xml and add your font yourself there, drawback is that an update will override your changes
<field name="googleFonts" type="list" default="font-family: 'Open Sans', sans-serif;|Open+Sans" label="Google Fonts *"
       description="Google Fonts, hit save css if changing this settings!">
   <option value="font-family: 'Just Me Again Down Here', cursive;|Just+Me+Again+Down+Here">Just Me Again Down Here</option>
   <option value="font-family: 'Great Vibes', cursive;|Great+Vibes">Great Vibes cursive</option>
   <option value="font-family: 'Open Sans', sans-serif;|Open+Sans">Open Sans</option>
</field>

Hit save!

If you change Google font familly, you HAVE to go to the template manager and hit save once to automatically make change to the css. As soon as I discover how to plug myself in the configuration editor of Joomla, i will do this in the background

CedTagsSupportGoogleFonts.png


Template Manager

Customizing layout Use the template manager to edit the css online


Maintenance

cedTag version >= 2.6.1

This new page will let you perform basic maintenance operations. Feel Free to ask for more operations using the support channel (Forums or Feedback (UserVoice))

Replace Tag xxxx with Tag yyyy in all articles with Tag xxxx

Cedtag 2-6-1 maintenance-replace-tags.png

Add Tag yyyy to all articles which have also Tag xxxx

Cedtag 2-6-1 maintenance-add-tags.png

Remove Tag xxxx to all articles which have also Tag yyyy

Cedtag 2-6-1 maintenance-remove-tags.png

Import Tags

TODO

Export Tags

The system currently support export function to

  • Joomla Meta-keys
  • CSV file

Export to Joomla Meta-keys

This will export back all your tags to the meta keywords of each article

Export to CSV File

A comma-separated values (CSV) file stores tabular data (numbers and text) in plain-text form. Plain text means that the file is a sequence of characters, with no data that has to be interpreted instead, as binary numbers. A CSV file consists of any number of records, separated by line breaks of some kind; each record consists of fields, separated by some other character or string, most commonly a literal TAB or comma. Usually, all records have an identical sequence of fields.

This let you export conveniently to a comma separated file that can be viewed later in excel, openoffice, google docs....

Statistics

CedTag statistics.png
  • How many terms are published/unpublished in percentage
  • How many terms are having descriptions
  • How many articles are still not being tagged

Stop Words

CedTags hasStopWords 02.png

Common words such as prepositions that are excluded from natural language. These terms will be always filtered out in frontend, backend and can not be used. http://en.wikipedia.org/wiki/Stop_words

StopWords do not appear as Terms because they are either insignificant (i.e., articles, prepositions) or common

Access Control List (ACL)

cedTag support Joomla 2.5 ACL. All operations are restricted for the logged in user. Due to the nature of ACL, some part of the control panel may not be displayed because you lack the permission to create, edit or delete content. see http://magazine.joomla.org/issues/Issue-Jan-2012/item/637-Joomla-1-6,-1-7,-and-2-5-ACL-Concepts-Overview

Deinstall / remove

version >= 2.6.0

Just de-install the component to remove all plugins and modules in one shot. Go to the Extension Manager under the tab Manage, enter in filter "tag", select cedtag component and click Actions - Uninstall

version < 2.6.0

Go to the Extension Manager under the tab Manage, enter in filter "tags", select all and click Actions - Uninstall

I have no access to my site anymore after having uninstall cedTag!

If you can not access your site, after having partially remove one or more but not all component of cedTag, just download http://www.waltercedric.com/download/cedTagOff.zip and unpack this file cedTagOff.php

to the root directory of your joomla installation and access it in a browser

http://www-your.site.com/cedTagOff.php

This will switch off all left behind extension that were not properly removed and give you access to your site frontend and backend. After you have regain access to your backend, just uninstall cedTag properly

  • Go to the Extension Manager under the tab Manage, enter in filter "tags", select all and click Actions - Uninstall


Download

http://www.waltercedric.com/downloads/cedtags.html


Joomla 3.1

Remove cedtag before updating to Joomla 3.1! my component cedtag is now colliding with the internal component name of Joomla Tag! both are named com_tag! You wont loose any data by removing cedtag, databases tables will remains.

How to migrate from cedtag to joomla 3.1.x Tag component

Why ?

Joomla 3.1.x has a better build in internal tags solution that differ from cedtag:

  • com_tags support multi languages,
  • com_tags support tags hierarchy,
  • is build in Joomla core which mean a clear roadmap and better support.

It still miss some nice features of cedtag, but the may be added by me or somebody else in the future!

In order to move away from cedTag and import all your cedTag tags into Joomla 3.1.x you can follow these steps

  1. Download the migrator tool from http://download.waltercedric.com/cedTag/cedtag_migration.zip
  2. Unpack into any folder on your site, for example in the root, so you can call the script fro example like this http://www.waltercedric.com/step{X}.php
  3. do a database backup using your favorite mysql admin tool being phpmyadmin or the command line (mysqldump -uuser -p db > dbbackup.sql)
  4. Remove CedTag, by uninstall ALL of it components
  5. Update to joomla 3.1

Step 1

Run http://yousite.com/step1.php this produce a SQL that you can cut and paste directly in phpmyadmin, it will populate the internal tables of Tag for Joomla with the old data from cedtag

Step 2

Run http://yousite.com/step2.php this produce a SQL that you can cut and paste directly in phpmyadmin, it will Populate #__contentitem_tag_map accordingly (which entry in ucm_content will get which tags, yes the tag component of joomla use #_ucm_content and not #_content)

Step 3

Run http://yousite.com/step3.php

this produce a SQL that you can cut and paste directly in phpmyadmin, it will Populate #__content accordingly, com_content still use #__content to display article on your site, so we have to add to every articles the list of tags it was previously using from cedtag.

FAQs

In the cedTag blog layout, is it possible to cut some of the text and add read more automatically?

Yes! when editing or writing a new Joomla Post, use the read more button of your favorite editor to add what Joomla call a FullText. The structure is like this

[introtext]
<hr id="system-readmore" />
[fulltext]


In clear text: if you use only Joomla intro text, in blog layout they won't be any button for displaying the fulltext.

Users logged in fron tend see a text "There is 4 ways to insert a tag after inputting some text: comma..."

this is correct for registered or logged in user, they see this text, and just below can enter or remove tags using an auto completion search. If the user generally has permissions to add content, they qualify.(editor, publisher, admin, etc) also to edit/delete tags while logged in front end. Otherwise the user can only see tags

For word like ph-fe tag ph and fe are created not a single tag

As default the character "-" is stripped/removed, go to the admin panel, under "Tags", remove the character "-" and reimport tags from Joomla Meta Keywords or correct the tag manually usign the Tag Manager

Sef url support

for usage (for example) /tag/ prefix in sef-Url you need to create menu item with "tag" alias,

So... it means, that better idea not to fill /tag/-part of the URL from settings, but just to see if there any menu item exists, and look to it's alias name. What do you think?


It would be nice to have a title more meaningful than just the Tag word, maybe something like "Articles tagged ..."

To do that, edit the file plugins\content\cedTags\language\en-GB\en-GB.plg_content_cedtags.ini and change the value of the key

PLG_CONTENT_CEDTAGS_ARTICLE_TAGGED=""

Is there any way to specify a Title (H2, H3) if creating a link to a Wordle?

Yes edit the English translation file at language\en-GB\en-GB.com_cedtag.ini and change the value of

COM_CEDTAG_WORDLE_H1="All Tags"
COM_CEDTAG_WORDLE_H2="h2"
COM_CEDTAG_WORDLE_H3=""
COM_CEDTAG_WORDLE_TEXT="A tag is like a subject or category. This page shows all tags in weighted order. The bigger the text, the more active the tag is."

Do this for all the language your Joomla instance has to support!

I don't see any modules in the list of existing modules, where are they?

The installation process do not create default modules for you, you have to go to the module manager, and click new to create the 5 different modules available

  • Module Latest Tags
  • Module Popular Tags
  • Module Random Tags
  • Module Custom Tags
  • Module Most Read Tags


In configuration I have chosen to show the tags beneat the article but they stil at the top.

Under Settings, tab "Frontpage" then "Tags Frontpage Position", select the position of the tag list

Strict Standards: Only variables should be assigned by reference in install.script.php on line 164 /253

I use a third party installer from http://www.rockettheme.com which is gpl, the error is in there, i made a correction and did update the package, simply redownload and install on top of your existing install to make this nasty error disapear

Add comma between two tag

edit css tagcloud.css and put the character you want, here tag are separated by comma and end with a dot

.cedtag li:after {
    content: ", "; /* you can place here a , or any character to clearly separate tags */
    padding-right: 2px;
}
.cedtag li:last-child:after
{
    content: "."; /* but leave the last child empty */
    padding-right: 2px;
}

Spaces in Tag

in configuration in tag section if you select "Spaces in Tag allowed" you will be able to enter new Tags with space

Support

http://forums.waltercedric.com/index.php


History

2.6.1

see TODO

2.6.0

see http://www.waltercedric.com/joomlacms/2098-cedtag-260-for-j25-released-for-joomla-25

2.5.6

see http://www.waltercedric.com/joomlacms/2065-cedtag-256-for-j25-released

2.5.4

  • NEW: Wikipedia auto-completion of tag descriptions with Wikipedia OpenSearch API! Support more than 40 localized Wikipedia servers (all Wikipedia with more than 100’000 articles)
  • BUG: Code cleaning, according to Joomla standard: my dream is to have this extension accepted in Joomla core! Still a lot of PHP Unit test to be written before submitting this to the mailing list of Joomla developers. Now I use Joomla CodeSniffer and PSR-1 CodeSniffer rules in my day to day development.
  • BUG: after click on Template Manager it show this err Fatal error: Class 'UsersHelper' not found in /home/assafir/public_html/administrator/components/com_cedtag/views/css/view.html.php on line 41
  • BUG: tags were not inserted automatically from new content article in frontend,
  • NEW: tags can also now be automatically inserted when new article is entered from the backend,
  • NEW: new configuration settings “Force Existing articles get their tags updated always from article meta keywords at save time” under Tab Tags (default is No)
  • NEW: Supporting tags containing many words separated by space: There are normally 5 ways to insert a tag after inputting some text: space, comma, enter, selecting an autocomplete option, or defocusing the widget. Now space now longer save the tag: You can enter tags with space as a result.
  • NEW: inline documentation when adding tag in frontend

2.5.3

  • NEW: auto completion of tags in frontend and backend using jQuery. You can add new tags, search and remove tags without fearing creating duplicates!
  • NEW: Joomla ACL support,
  • NEW: use confirmation popup windows for all delete/clear operations,
  • NEW: new option to switch off tags title in front page,
  • NEW: no white background in simple.css for people loving their black background as default,
  • NEW: cedTag is now having no warnings/errors in PHP error level E_STRICT
  • BUG: i cant disable cedTag on front page when i disable it any thing not change...i want show tags only on full article view...
  • BUG: working update manager: starting at version 2.5.3 you can update with one click in the update manager.
  • BUG: did remove a hack of me for testing -> it was not possible to switch off the add tags button in frontend since i fixcoded to true :-(
  • BUG: correct issue in editor xtd plugin blocking users to edit/view articles in frontend
  • Code cleaning: Rewrite 90% of all query string to use the $query object api of joomla, Did clean the content plugin a lot,

2.5.2

{{#widget:DISQUS|id=cdricwalterwiki|uniqid=Taxonomies and Tags support for Joomla|url=http://wiki.waltercedric.com/index.php?title=Taxonomies_and_Tags_support_for_Joomla}}