[CDB] RH Topic Tags

[combuster]

Extension Name: RH Topic Tags
Author: combuster

Extension Description::
phpBB 3.1 extension, that adds the ability to tag topics with key words.

Extension Version:: 1.0.1

Features:
implemented:
see https://github.com/RobertHeim/phpbb-ext ... d#features

planned features and issues:
https://github.com/RobertHeim/phpbb-ext ... ags/issues

Screenshots:

The interface is only visible when posting new topic or editing the first post:


tag cloud with usage-count disabled:


responsive design tag cloud with usage count enabled:


Route: /tag/basic,advanced/OR


Route: /tag/basic,advanced/AND


[url=ACP:][img]ACP:[/img][/url]

Settings:

manage tags:

whitelist:

blacklist:


Extension Download:

• zip: https://github.com/RobertHeim/phpbb-ext ... /1.0.1.zip
• tar.gz: https://github.com/RobertHeim/phpbb-ext ... 0.1.tar.gz

Extension Repository:

Github: https://github.com/RobertHeim/phpbb-ext-topictags

Installation:

1. Clone (or download an move) the repository into the folder phpBB3/ext/robertheim/topictags:
   

   Code: Select all

   cd phpBB3
   git clone https://github.com/RobertHeim/phpbb-ext-topictags.git ext/robertheim/topictags/
   

2. Go to ACP -> tab customise -> Manage extensions -> enable RH Topic Tags
3. Go to ACP -> Forums -> edit/create any forum -> set Enable RH Topic Tags to Yes
4. Goto ACP -> Extensions -> RH Topic Tags for global settings and maintenance

Donation:
Please donate to any charity organisation or buyme a bear on my blog, Thanks!

[combuster]

Changelog:

Since 1.0.0

• bug fixes

Since 0.0.14-RC1

• improved code quality
• tests
• bug fixes

Since 0.0.12-DEV

• improved code quality
• added over 600 assertions in over 40 tests
• bug fixes

Since 0.0.11-DEV

• fancy UI
• tag suggestions based on existing tags
• list of all tags in ACP with option to delete, merge and rename the tags
• fixed a lot of bugs

Since 0.0.10-DEV

• urlencode tags in routes
• handle invalid tags in route /tags
• other minor bug fixes

Since 0.0.9-DEV

• fully support utf8 characters
• bug fixes

Since 0.0.8-DEV

• added user permission for adding tags and mod/admin permissions for editing as well
• added whitelist & blacklist
• allow whitespaces and convert them to "-" by default + ACP option to disable this
• removed redundant language entries
• fix bug where forum setting "Enable RH Topic Tags" was always "No"
• dont count tags in tagging-disabled forums and dont show them in tag cloud
• made tag-count in tag cloud readable
• link from index to /tags (showing all tags)
• worked on conforming to coding guidelines
• fixed several bugs

Since 0.0.7-DEV

• improved structure for ACP settings
• acp option for tagcloud to be displayed on index or not
• acp option to limit count of tags shown in tagcloud
• dynamic tag-size in tag cloud depending on its usage count
• acp option to en/disable display of usage count of tags in tag cloud
• cleaned css code

Since 0.0.6-DEV

• style tags in viewforum / topic-list

Since 0.0.6-DEV

• better explanation of acp option for pruning invalid-tags

Since 0.0.4-DEV

• tags are shown in viewforum (can be disabled in acp)

Since 0.0.3-DEV

• added topic-tags to meta-content keywords
• paginated results when searching for topics by tags
• added spanish translation (thanks Raul [ThE KuKa] )
• show user an explenation about tag-constraints (configurable in ACP)
• made regex for tag-validation configurable, by default its: /^[a-z0-9]{3,30}$/i
• search can be both case-sensitive or -insensitive (default)
• ignore invalid tags on search by tag
• validate tags and give proper error messages
• fixed several bugs

Since 0.0.2-DEV

• styled tagcloud
• styled topic list on route /tag/{tags}/{mode}
• improved search by tag: route /tag/{tags}/{mode} where mode can be AND or OR and tags can be several comma separated tags.
• fixed link from show-tag topics-list to userprofile
• fixed link to show-tag from viewtopic
• fixed installation

Since 0.0.1-DEV

• added tags-overview page app.php/tags
• implemented rudimentary "topics by tag" -> app.php/tag/{tag}

[combuster]

First preview-release is up.

It implements the basic feature of adding tags to a topic and showing them in viewtopic.

[combuster]

Another preview release:
added a (rudimentary!) tag cloud (route: app.php/tags) and (rudimentary!) list of topics by tag(s) (route: app.php/tag/{tag} (note the missing s in "tag(s)"!).

[Kailey]

Neat! I would suggest using CSS to style the list and make it look "pretty".

[combuster]

@kmtruscott: sure! we are in DEV-Stage so there is plenty of work and its just a pre-view release ;O

[combuster]

Alight,

another huge update! The tagscloud (/tags) and the show-tag(s) (/tag/{tags}/{mode}) are now styled. Additionally many bugs have been fixed - but still there is a bunch of work left.

Note: The 0.0.3-DEV - Release has been updated - same links=new code (see first post for links)!

[combuster]

I added some screenshots to the first post! =)

[Meis2M]

very lovely mod...

can u add ability to add automatic tags from title of topic?

[Kailey]

can u add ability to add automatic tags from title of topic?

What's the point of having the extension installed if it is just going to repeat the topic title? Also with your suggestion, topic titles such as "HHHEEEEEEELLLLLPPPP!!!!!!" and "PLEASE HELP ME URGENT!" would actually get tagged as such, making the tagging system useless in those cases. If you don't think this happens, browse the 3.0 Support Forum.

I would like to see a setting that makes tags optional or required (per forum, obviously). Otherwise, great extension.

[combuster]

@Meis2M

Hi,

thanks!
This feature is not planned, but you can easily implement it with another extension. I think you could just do it with JS when posting new topic /editing first post to translate the topic into the tags-input-field before they are submitted.


Greets

[combuster]

I would like to see a setting that makes tags optional or required (per forum, obviously). Otherwise, great extension.

yes, I need this as well, and I plan to address that in future.
Currently I think that this might be part of another mod, and not the core tagging-system. I dont know yet.

BTW: If someone wants to help me with implementation, feel free to contact me via PN or github! Would love to have some helping hands, because I work 40h/week.. :-/

[Meis2M]

@Meis2M

Hi,

thanks!
This feature is not planned, but you can easily implement it with another extension. I think you could just do it with JS when posting new topic /editing first post to translate the topic into the tags-input-field before they are submitted.


Greets

Hi
very good idea for auto tag. i cant do that yet. i like see some one do that with acp setting to enable or forum permission.

another question:
this tags add as keywords in:

Code: Select all

<meta name="keywords" content="" />

?
it is useful for seo.

[combuster]

very good idea for auto tag. i cant do that yet. i like see some one do that with acp setting to enable or forum permission.

the extension will support enabling tagging on per forum basis.

another question:
this tags add as keywords in:

Code: Select all

<meta name="keywords" content="" />

yes thanks for idea: https://github.com/RobertHeim/phpbb-ext ... /issues/10

[leschek]

Interesting extension. I looked into language files and there are some small issues making translating hard:

1. This line 'RH_TOPICTAGS_EXP' => 'Tags separated by comma (",")', is twice in file language/en/topictags.php

2. It's hard to translate these sentences:

Code: Select all

'RH_TOPICTAGS_SEARCH_HEADER'		=> 'Search for topics with %s of these tags: %s', // %s=any||all, %s=tags,
'RH_TOPICTAGS_NO_TOPICS_FOR_TAG'	=> 'There are no topics tagged with %s of these tags: %s', // %s=any||all, %s=tags,

into Czech language (and possibly into other languages as well). It is not possible to change only one word to make different sentence. It would be great if you could change it into something like this:

Code: Select all

'RH_TOPICTAGS_SEARCH_HEADER_ANY'		=> 'Search for topics with any of these tags: %s',
        'RH_TOPICTAGS_SEARCH_HEADER_ALL'		=> 'Search for topics with all of these tags: %s',
	'RH_TOPICTAGS_NO_TOPICS_FOR_TAG_ANY'	=> 'There are no topics tagged with any of these tags: %s',
	'RH_TOPICTAGS_NO_TOPICS_FOR_TAG_ALL'	=> 'There are no topics tagged with all of these tags: %s',

And then (I guess) those lines would be redundant:

Code: Select all

	'RH_TOPICTAGS_ANY'					=> 'any',
	'RH_TOPICTAGS_ALL'					=> 'all',