End-User Options - Abbreviations/Acronyms (MathJax Compatible)

Overview

This product allows you to define a set of abbreviations/acronyms that will have a tooltip explanation defined for your users who may not be familiar with these abbreviations and will find an explanation useful. You can define which areas of your site this product is active and your users can also decide if they wish for the product to be active for them in their settings. If you use MathJax on your site for mathematical expressions, you will find this product is completely compatible with it, and will not break such expressions.

Upon installation, a custom user profile field is auto-created to allow your users control over use of this product, and this field is deleted if you uninstall the product.



The product settings are divided into two primary groups: the first pertaining to the abbreviations/acronyms and the second to your implementation of MathJax. If you are not using MathJax, then you can simply ignore that section.

Abbreviations/Acronyms Details

Here you will find a textarea for defining your list of abbreviations and acronyms. Each one should be place on a separate line, with the abbreviation/acronym first, then a pipe symbol ("|"), followed by the explanation you want to appear in the tooltip. If you wish for your tooltip to contain line breaks, then use "\n" (without the quotes) for these breaks. When you save your settings, the list is alphabetically sorted to make locating these definitions easier in the future.

Next, you can set the areas of your site in which this product will be active, including Posts, Signatures, Private Messages, Visitor Messages and Group Messages.

You can then set whether you wish for this product to be active for guests.

MathJax Details

If you do not use MathJax, then you need not make any changes here.

If you do use MathJax, then first you need to define whether you have their script(s) manually defined in your templates or if you are using my product for its dynamic implementation. I recommend using my product for the most reliable and efficient compatibility.

If you use MathJax's default delimiters, then you need not change them, as the defaults are already defined by this product. However, if you have defined your own delimiters, then all delimiters you have defined need to be given in the delimiter settings.

Updates:

Version 1.1:

• I discovered a MySQL function I was using was deprecated as of 5.5, so I replaced it with a query.
• Fixed bug whereby the preview of a post in a new thread now shows the acronyms.

Version 1.2:

• Fixed bug where "/" character in an abbreviation caused a PHP error.
• Fixed bug where acronym at the beginning of a text string will now work.

Version 1.3:

• Profile filed number of auto-created field cached so a db query is no longer required each time text is parsed.

Version 1.3.1:

• HTML special characters may now be used in abbreviations/acronyms.

Version 1.4:

• Admin options processing more efficient.
• Added setting for "Active Forums."
• Fixed issue where hex colors within COLOR BBCode containing abbreviations broke posts.

Version 1.4.1:

• Dotted underline is now the same color as the text.

Version 1.4.2:

• Fixed issue with non-Latin characters.

Compatibility:

Tested and working on VB 4.2.x and should work on all 4.x versions of vBulletin.

Backup/Warning:

This product alters your database, however it is always good practice to make regular backups and you should make a backup before installing ANY new mod.

As always, products are USE AT YOUR OWN RISK. I will provide support and do my best to help but no absolute guarantee is offered.

To Install:

1.) Download and extract the attached .zip file.
2.) Upload the contents of the "upload" folder to your forum's root directory.
3.) Follow AdminCP -> Plugins & Products -> Manage Products -> Add/Import Product.
4.) Click on "Choose File" and browse to the product .xml file that was packaged in the .zip file.
5.) Click "Import."
6.) You MUST enable the product in the settings before it will function.
7.) Configure the remaining settings to your liking. Each setting has a detailed explanation of its use.

Support for this product can be found here:

• MHB - Abbreviations/Acronyms (MathJax Compatible)
• TAZ - Abbreviations/Acronyms (MathJax Compatible)

[Alan_SP]

Very nice idea, and can be used for other things as well. :up:

Possible idea, if we could use it for adding some links in certain scenarios with additional parameter after second | e.g. "Amazon|Online Bookstore|http://www.amazon.com"

I know that there is similar product from BOP5 (if I'm not mistaken), but sometimes we could make it a link. And, if you think it's good idea and doable, can that link be made with different CSS than "normal" links, so it graphically looks different from normal links?

With this new links we could use it for different purposes, for additional explanation, for autolinking certain keywords, just explaining some things additionally...

Speaking about this, what if some acronym has more than one meaning? I see we could make something like this: "ALA|1. Alpha Lipoic Acid\n2. Alpha Linoleic Acid" (link for ALA: https://en.wikipedia.org/wiki/Ala) This probably would work?

[MarkFL]

Update: version 1.1

• I discovered a MySQL function I was using was deprecated as of 5.5, so I replaced it with a query.
• Fixed bug whereby the preview of a post in a new thread now shows the acronyms.

[MarkFL]

Update: version 1.2

• Fixed bug where "/" character in an abbreviation caused a PHP error.
• Fixed bug where acronym at the beginning of a text string will now work.

[VCCN]

Hi, great plugin - excactly what we need - but it doesn't seems to work with 4.2.2 - i have installed according to the instructions as well as set the product as "Active" - but my acronyms does not get underline or tool tip when mouseover.
Any tip to get it working?

[MarkFL]

Originally Posted by VCCN

Hi, great plugin - excactly what we need - but it doesn't seems to work with 4.2.2 - i have installed according to the instructions as well as set the product as "Active" - but my acronyms does not get underline or tool tip when mouseover.
Any tip to get it working?

I use it on a vB 4.2.2 PL 4 site with no issues. There is most likely a conflict with another product.

Do they not work anywhere on your site?

[VCCN]

Correct, does not work at all.

I have tried two other mods that do the same thing, they worked fine, but had a few issues. i removed them before i installed this.

[MarkFL]

Okay, I will have to come to your site to troubleshoot. Please PM me the login credentials for a temporary admin account.

[VCCN]

Originally Posted by MarkFL

Okay, I will have to come to your site to troubleshoot. Please PM me the login credentials for a temporary admin account.

PM sent !

[eh69]

I cant uninstall this

please help
Database error in vBulletin 4.2.3:

Invalid SQL:

DELETE FROM vb_profilefield
WHERE profilefieldid =;

MySQL Error : You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '' at line 2
Error Number : 1064
Request Date : Sunday, February 28th 2016 @ 08:49:58 PM