QuickReferences 1.2

7 Aug 2016 Edited
#1
QuickReferences is a simple plugin which lets you reference to other threads quickly using their identifiers. Thanks to At.js, a dropdown list will be generated everytime your users type an hashtag (#) followed by the threads name they want to search for. The dropdown is attached to textareas and MyBB's default WYSIWYG editor (SCEditor) both in WYSIWYG and Source modes when you post a new thread, new reply, edit a post, perform a quick reply and perform a quick edit (basically, everywhere it is most useful).

CKEditor-based plugins (including Rin Editor) are supported.

Starting from 1.2, Unicode characters are supported.

[Image: WiE0XgP.gif]

Technical implementation


QuickReferences exploits AJAX to query the database for a list of threads containing your search words. It's packed with a stupidly simple caching system which prevents sending too many queries, saving resources. Results are limited to 5 threads per search query and when a query string returns less than 5 threads, it stops querying the database and gets threads from the cache.

On the backend side, hashtags followed by threads identifiers are matched using a regular expression and replaced by a placeholder when singular posts are parsed. In the end, a single query of all collected thread identifiers is performed and existing threads ultimately replace valid placeholders. Non existing threads are not parsed and their corresponding placeholders are restored by the original matched string.

Customization


You can customize links generated by QuickReferences by using the CSS class .quick_reference.

Requirements


QuickReferences requires MyBB 1.8.0+ and PHP 5.4+.

You can follow the plugin's development here: QuickReferences development.

Installation instructions


The installation is as simple as uploading the files maintaining the same folder structure they are compiled to and clicking the button Install & activate within your board's plugin list.

QuickReferences does not add any settings.

QuickReferences adds a CSS file named at.css to every theme of your board. You can customize the dropdown's appearance by editing the stylesheet's CSS rules.

Upgrading instructions from older versions to newer ones


Simply upload the new files, replacing the old ones. You don't need to uninstall the plugin.

Reporting issues


If you encounter an issue, feel free to open a new thread in this forum with detailed instructions on how to reproduce your issue. Suggestions and feature requests are appreciated as well.
Filename Size Downloads
19.31 KB 185
Enes Palit, Jopie, honger And 2 others like this post
Entity 7 Aug 2016 Edited
#2
This is one of the coolest plugins I've seen for MyBB.

Thanks for making this, people like you are the reason why MyBB will always be my favorite software.
Dr.Jeet 7 Aug 2016 Edited
#3
wow...excellent plugin.

Suggestion: Is it possible to add username also through #???
superb.
Brenda 7 Aug 2016
#4
Thanks, looking forward for more plugin releases. : )
Shade 7 Aug 2016 Edited
#5
Suggestion: Is it possible to add username also through #?
Dr.Jeet (7 Aug 2016)
MyBBoost has a slightly modified version of QuickReferences which adds support for username tagging. However it will not be released as a plugin nor it will be added to the official QuickReferences release. By the way, it is accessible using the at (@) character, not the hashtag (#) which is reserved to threads.

Thank you guys for your kind words.
Dr.Jeet 8 Aug 2016
#6
Ohh....
Ok. Thank you. If you add to quick reference than it will be very helpful.
think for it.
Great work bro.
thanks.
Shade 8 Aug 2016
#7
However it will not be released as a plugin nor it will be added to the official QuickReferences release.
Shade (7 Aug 2016)
That's my last word. I will not release it, no matter how you insist.
Shade 9 Aug 2016 Edited
#8

QuickReferences 1.1 is out


QuickReferences 1.1 has been released and it's available to the public in the first post of this thread. To see the changelog, see QuickReferences development.

Special thanks go to @Brenda and @kopa for spotting bugs and testing its functionalities.
Brenda 9 Aug 2016
#9
Thanks for the quick fix and release. A great plugin, good job.
Eldenroot 9 Aug 2016 Edited
#10
However it will not be released as a plugin nor it will be added to the official QuickReferences release.
Shade (8 Aug 2016)
That's my last word. I will not release it, no matter how you insist.
Shade (7 Aug 2016)
Any specific reason? Nevermind, thank you for this awesome plugin :)

There is a small bug - type "#a" for example - when you type one letter it is highlighted only is some cases, not every "a".

Also can you please add a support for Group setting + CSS support for easy customization (color and style of link, etc).