Skip to content

Commit

Permalink
1.9.0
Browse files Browse the repository at this point in the history
  • Loading branch information
svivian committed Dec 14, 2018
1 parent b841a22 commit 2df0440
Show file tree
Hide file tree
Showing 2 changed files with 19 additions and 15 deletions.
30 changes: 17 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,31 +6,35 @@ This is an event plugin for popular open source Q&A platform, [Question2Answer](

For example if you had `websites` as a tag, some users may tag a question with `website` instead. With this plugin you can set `website` to always be changed to `websites` when a user enters it.

Other features include min/max tag length and redirecting old tag pages to the new synonym.


Installation & Usage

Pay What You Like
-------------------------------------------------

1. Download and extract the files to a subfolder such as `tagging-tools` inside the `qa-plugins` folder of your Q2A installation. Since the Github repo is updated regularly, a stable versioned package is also provided, e.g. `Q2A-Tagging-Tools-1.5.zip`
Most of my code is released under the open source GPLv3 license, and provided with a 'Pay What You Like' approach. Feel free to download and modify the code to suit your needs, and I hope you value it enough to make a small donation - any amount is welcome.

### [Donate here](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=4R5SHBNM3UDLU&source=url)

2. If your site is a different language from English, copy `qa-tt-lang-default.php` to the required language code (e.g. `qa-tt-lang-de.php` for German) and edit the phrases for your language.

3. Log in to your Q2A site as a Super Administrator and head to Admin > Plugins.

4. Under "Tagging Tools", enter each pair of tags on a new line, separated by a comma. For example, `q2a,question2answer` (without quotes) means that a tag of `q2a` will be replaced by `question2answer`, while `help` on its own line means that tag will be removed.
Installation & Usage
-------------------------------------------------

5. Click the button to save changes. All future questions will replace your chosen tag synonyms.
1. Download and extract the files to a subfolder such as `tagging-tools` inside the `qa-plugins` folder of your Q2A installation. Check the [releases page](https://github.com/svivian/q2a-tagging-tools/releases) for the latest official version.

6. If you have existing mistagged questions, tick the checkbox to replace all tags in older questions with your synonyms.
WARNING: if you have a lot of questions on your site, converting all the old questions will take a long time. Version 1.5 now uses AJAX to edit a few posts at a time, however, it may still cause high MySQL and Apache CPU usage. It's recommended that you add tag synonyms a handful at a time to avoid too much overhead.
2. If your site is a different language from English, copy `qa-tt-lang-default.php` to the required language code (e.g. `qa-tt-lang-de.php` for German) and edit the phrases for your language.

7. The option "Prevent new users from creating new tags" adds a JavaScript barrier preventing low-rep users from creating new tags. However, due to its nature it only checks against the tags in the `qa_tags_complete` that are used for auto-complete. The server-side filter checks against all tags. In other words, if JS is turned off the user can input a tag not in the most popular 1000 but it must already exist.
3. Log in to your Q2A site as an Administrator and head to Admin > Plugins.

4. Under "Tagging Tools", enter each pair of tags on a new line, separated by a comma. For example, `q2a,question2answer` (without quotes) means that a tag of `q2a` will be replaced by `question2answer`, while `help` on its own line means that tag will be removed. Save the changes and all future questions will replace your chosen tag synonyms.

5. If you have existing mistagged questions, tick the checkbox to replace all tags in older questions with your synonyms.
WARNING: if you have a lot of questions on your site, converting all the old questions will take a long time. It's recommended that you add tag synonyms a handful at a time to avoid too much overhead.

Pay What You Like
-------------------------------------------------
6. The minimum/maximum length options do as the name suggests - prevent users from entering tags that are too long or too short.

Most of my code is released under the open source GPLv3 license, and provided with a 'Pay What You Like' approach. Feel free to download and modify the plugins/themes to suit your needs, and I hope you value them enough to make a small donation of a few dollars or more.
7. The new tags option limits users under a point threshold to using existing tags only. On the front-end it adds a JavaScript barrier, which for performance reasons only checks against the top tags (number as determined by the `QA_DB_RETRIEVE_COMPLETE_TAGS` constant) that are used for auto-complete. The server-side filter checks against all tags, i.e. if JS is turned off the user can input a tag not in the most popular but it must already exist.

### [Donate here](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=4R5SHBNM3UDLU)
8. The redirects option will add 301 redirects from old tag pages to new tag pages. For example if you change `q2a` to `question2answer` then the page `example.com/tag/q2a` would now be blank, so this option will redirect the page to `example.com/tag/question2answer`. If you use this feature, make sure to convert all existing tag synonyms! Otherwise if you still have some questions with the old tags, those tag pages will not be viewable any more.
4 changes: 2 additions & 2 deletions metadata.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@
"name": "Tagging Tools",
"uri": "https://github.com/svivian/q2a-tagging-tools",
"description": "Automatically modify/remove tags in questions",
"version": "1.8.7",
"date": "2018-11-28",
"version": "1.9.0",
"date": "2018-12-14",
"author": "Scott Vivian",
"author_uri": "http://codelair.com",
"license": "GPLv3",
Expand Down

0 comments on commit 2df0440

Please sign in to comment.