• This forum has been archived. New threads and replies may not be made. All add-ons/resources that are active should be migrated to the Resource Manager. See this thread for more information.

TaigaChat - AJAX shoutbox

Not open for further replies.

Luke F

Well-known member
(Now with BBCode toolbar!)

^ Choice of either sidebar or above/below forum list

3dir.webp eexb.webp 7a9_.webp

Admin panel screenshot:


  1. Upload contents of upload folder to forum root
  2. Install addon-TaigaChat.xml file
  3. Add the template include code to forum_list either above or below the sidebar_online_users include (whatever you feel looks best):
    <xen:include template="dark_taigachat" />
    Or, if you want the shoutbox above or below your forum list, add the following code to forum_list:
    <xen:include template="dark_taigachat"><xen:set var="$taigachat_alt">1</xen:set></xen:include>
    Either just before or just after:
    <xen:if is="{$renderedNodes}"><xen:include template="node_list" /></xen:if>
  4. Configure the permissions (view, post, modify own, modify all) for your user groups. If you have trouble accessing the modify tools, ensure the Administrative group is your primary usergroup rather than a secondary one.
  5. Optionally (for XenPorta support), upload the contents xenPorta/upload folder to your forum root and import xenPorta/xenPorta_TaigaChat.xml as a block.
Updating: (0.5.3 to 0.5.4)

  1. Upload the contents of upload folder to your forum root, overwriting all files.
  2. Perform upgrade process with the new addon xml file.
  3. Revert and merge any template changes to TaigaChat templates.
  4. Update XenPorta block if applicable
Updating: (0.5.4 to 0.5.5)

  1. Upload the contents of upload folder to your forum root, overwriting all files.
  2. Perform upgrade process with the new addon xml file (optional, no changes)

0.5.5 (12/12/2011):
  • Optimised smilie loading (now uses cache)
  • Fixed smilie ordering
0.5.4 (11/12/2011):
  • Fixed smilies not working correctly if using sprite mode
  • Fixed media tags not parsing to links correctly in limited bbcode modes
  • Updated XenPorta module to work with XenPorta 1.5+
  • Fixed issues with /find-new/ + others and general improper hooking
  • Added new option 'Global hook' allowing you to include the template code literally anywhere
0.5.3 (03/08/2011):
  • New messages now fetched by id rather than time
0.5.2 (03/08/2011):
  • Fixed messages not appearing correctly when posted in quick succession.
  • Fixed AJAX indicator sometimes not disappearing when posting.
0.5.1 (03/08/2011):
  • Fixed broken templates in 0.5.0 due to failed XML export
0.5.0 (03/08/2011):
  • Improved server resource and bandwidth usage (only new messages are fetched, filtered whitespace).
  • Fixed various bugs with fetching and displaying messages.
  • Added new 'Timestamp format' option with new 'Time Only' and 'None' functionality.
  • Fixed popup using wrong taigachat.js URL (and therefore not working).
  • Fixed archive posts overflowing message length limit.
  • Posting the exact same message within 5 seconds is now prevented to alleviate accidental double posting etc.
  • Reduced default max refresh time to 10 seconds (120 was a poor design choice).
0.4.3 (28/03/2011):
  • Halved the number of AJAX requests used when posting.
  • Improved overall stability of the refreshing code, especially when sending messages in rapid succession.
  • Fixed regression in 0.4.2 causing the shoutbox to not load without posting permission.
  • Fixed tab/window focus detection in IE and Chrome
0.4.2 (27/03/2011):
  • Added refresh time decay (starting at 5 seconds, increases each time no messages are received up to a configurable limit).
  • Messages no longer build up past the maximum displayed number, which severely degraded client-side performance.
  • Smilies in the dropdown are now not loaded until needed.
  • Reduced the number of AJAX requests when replying to realtime conversations.
  • Fixed CSRF token expiring.
  • Links in shout messages now use the same styling as forum posts.
  • Fixed HTML5 breadcrumb microdata links not working
  • Optimised main message list query slightly.
0.4.1 (01/02/2011):
  • Improved caret positioning after BBCode has been added in all browsers.
  • Added [email] to 'none' and 'basic' BBCode levels.
  • Completely reworked the templates for tidier variable usage and fixed XenPorta support with the BBCode toolbar enabled.
  • Fixed smilies button wrapping to a new line in IE.
  • Fixed smilies list using one line per smilie in IE.
  • Fixed archive member URLs not being generated properly.
  • Fixed delete link and submit button not using active route in the edit message window.
  • Fixed messages posted very soon after page load not appearing instantly for the poster.
0.4.0 (01/02/2011):
  • Added configurable BBCode and Smilies toolbar.
  • Fixed rare fatal error, mostly on pages that would otherwise 404 (introduced in 0.3.0).
  • Fixed alternative view header link not using the active route setting.
0.3.2 (30/01/2011):
  • Added archiving to thread feature
  • Added support for the 'threads' action (i.e. What's New page)
  • Fixed hardcoded 'Guest' text
  • Possibly fixed rare error when AJAX requests are interrupted
0.3.1 (24/01/2011):
  • Gzipped AJAX refresh response resulting in vastly reduced size (~70kb -> ~5kb).
  • The fade effect will no longer occur when more than 1 message is received at once or if it is less than 15 seconds since the last fade.
  • Fixed double AJAX refresh when posting a message due to focus event bubbling.
  • Fixed error when editing messages introduced in 0.3.0.
  • Removed random '6' at the end of dark_taigachat.css
0.3.0 (23/01/2011):
  • Added alternative URL routes: /chat, /chatbox, /shoutbox, along with an admin option to select the primary route.
  • Added option for mini avatars (16x16px) next to messages.
  • Added 'Members in Chat' block on full view, showing members who have recently posted in the shoutbox or opened the full/popup view.
  • Added XenPorta module.
  • Added support for template code being included on pages other than the forum index.
  • Added option for absolute times rather than '5 minutes ago' etc.
  • Fixed 'Reverse direction' disabled not working correctly in popup view.
  • Fixed the shoutbox doing a double refresh on the initial load.
  • Improved width of popup view chat area at small window sizes.
  • Removed redundant template include in dark_taigachat_full
  • Removed pointless copyright/credit link (you're still welcome to donate though ;))
0.2.0 (21/11/2010):
  • Added Popup view
  • Added support for XenPorta (simply add the include code to one of its templates)
  • Users viewing the shoutbox no longer show up as viewing 'Unknown page' on the online list.
  • Users will now have their last activity date updated when posting shoutbox messages and will therefore no longer go offline while using the shoutbox.
  • Fixed 'Uncaught error'
  • Fixed redirection after editing/deleting messages with rewrites turned off.
  • The navigation tab and dropdown menu now use the XF link builder.
0.1.4 (03/11/2010):
  • Fixed server error some users were experiencing when installing or uninstalling the addon.
0.1.3 (01/11/2010):
  • Moved Message Tools dropdown to the left of the message timestamps.
  • Fixed 'Always show message tools dropdown' option, which previously also overrode full view.
  • Reimplemented permissions using built-in helper methods.
Donations go here. :)


  • taiga-cp.webp
    58.2 KB · Views: 755
  • TaigaChat.zip
    30.9 KB · Views: 433
Changelog: (Part 2)

0.1.2 (31/10/2010):
  • Fixed regression in 0.1.1 - plain URLs weren't being parsed into links correctly.
0.1.1 (31/10/2010):
  • Added alternative template code, suitable for inclusion above or below the forum list.
  • Added extra image display modes: Zoom and Thumbnail Zoom (the latter being the new default), both based on XenForo's click to expand system.
  • Added configurable BBCode parsing levels: Full (old behaviour), Basic (the new default; img, url, b, i, u, s, color) and None (url only).
  • Added height setting to the admin options.
  • Guest posting is now supported (with the appropriate permissions). Auto refresh will also apply for guests if they have permission to post.
  • Reorganised admin options page.
  • Added option (default off) for message tools to be displayed on the sidebar/alt view.
  • The Shoutbox tab is no longer shown to people who do not have the view permission.
  • Combined most of the dark_taigachat and dark_taigachat_full templates into a single template.
  • Javascript optimisation: no fading effect if 3 or more messages are being added at once.
  • Fixed Delete button on the Edit form not refreshing the page while in overlay mode.
0.1.0 (30/10/2010):
  • Added a full size shoutbox page.
  • Added admin settings: Refresh time, Enable, Reverse direction, [number of] Visible shouts, Add navbar tab, Maximum message length.
  • Added edit and delete controls on full size view.
  • Added permissions: view, post, modify own, modify all.
  • Added daily clean up cron to remove all but the latest 1000 messages (1000 in case an archive is added later).
  • Added automatic install/uninstall code.
  • Now makes use of xen:link etc. to correctly compensate for rewrites being off
  • Now uses JSON (and more of the XenForo javascript framework) rather than raw output, to allow for proper error handling, etc.
  • Messages will now display on the same line as username if possible, otherwise they will wrap directly after the username as before.
  • Made some optimisations to the Javascript (such as not refreshing the timestamps with every refresh)
  • Message input box now has a placeholder of 'Enter message...'
  • Various minor CSS changes
0.0.1 (29/10/2010):
  • First public release

Interesting. Does this go in the sidebar?

Yup it's designed for the sidebar, but you could put it wherever you want with nothing more than CSS and minor template changes.
thx good job I install it on ;)

EDIT : someone test me because it does not work when I send a message it does not send it! help me please :(
Is it possible to make the install part much easier
Because i don't like to play with databse !?
  • The Ability to Delete Chat Messages
  • The Ability to Clear all messages
thanx it looks great
still waiting for the next release
To empty the table just enter this command:

delete from dark_taigachat where date< ????

Replacing ???? with the time/date of the latest message you want to delete from.
Is it possible to have it appear downward instead of upward
meaning the newest post appear in the end of the sidebar
Seem to have found a problem.
Installed locally (Windows AMP), shoutbox displays correctly, but no shouts!
Firebug console gives me the following error: blah-blah-blah The requested URL /taigachat/list was not found on this server.
Any suggestions please?

UPDATE: Installed flawlessly on the 'live' linux box, working as designed.
The only other difference between the two is that the local installation also has the Portal installed.
Seem to have found a problem.
Installed locally (Windows AMP), shoutbox displays correctly, but no shouts!
Firebug console gives me the following error:

Any suggestions please?

UPDATE: Installed flawlessly on the 'live' linux box, working as designed.
The only other difference between the two is that the local installation also has the Portal installed.

Ah yeah, I forgot to compensate for people without full rewrites enabled. Thanks for reminding me :)

Also huge update coming soon :)
I'm not a big fan of shoutboxes, but I may add this as an extra feature to my membership-based 'supporters' group :)

Thanks Darkimmortal! :D
Not open for further replies.
Top Bottom