The Tricky.net

Messaging component manual

Installing the plugin

Start by downloading the latest release. Now acces the Joomla! back-end (the administration panel). Click on Extensions->Install/Uninstall. Upload the program and click on "Upload file & Install". The program is installed! You have to add the messaging system to the links in the main menu by going under Menus->Main Menu. Click on "New". In the new page click on messaging and select the "Messages->Default Layout" in the submenu (if you want to make a link to the "New Message" page, select "Message->Default Layout"). Now set Title to Messaging (or anything else you want) and set the acces level to "Registered". Click on "Apply". The installing is finished. The users can now use the messaging system.

Settings for the Administrator

The administrator can control different aspects of the program. The first thing is how the name suggestion should work. You can set "Suggested Name" to four different settings:
  • Username ->The usernames of the users will be shown in the name suggestion dialog
  • Name -> The name of the user will be shown
  • Both -> Both the username and the name will be shown
  • None -> Name suggestion will disabled
The next thing that can be set is "Send notify Email". If this is set to true, the user who receives the message gets an email notifying him he received an email. The user can use the personal settings tab to disable these mails entirely (this only works if the UserMeta plugin has been installed the right way).
The third setting is "Let users send messages to users". If this is set to true, users can send each other messages. If it is set to false, users can only send messages to administrators and administrators can send emails to anyone.
The last settings are for setting the inbox sizes. If you want all users to have the same inbox size, just change the value of the Default Size. If you want to change the sizes individually for administrators and users set the radio box to Yes. Then you can set the inbox size for each usertype.

Settings for the users

The user can only access one setting, disabling the messaging system for himself, and only if the administrator enables this function. To do this, install the UserMeta plugin. Enable the plugin and open the user.xml file in the following folder "plugins/system/usermeta/". Now insert the following piece of code after the last param tag but before the end of the params tag:
 
<param name="messaging" type="radio" default="1" label="Use messaging system" 
description="Use messaging system">
   <option value="0">No</option>
   <option value="1">Yes</option>
</param>
<param name="messaging_mail" type="radio" default="1" 
label="Receive an email when you receive a new message" description="Send Email">
   <option value="0">No</option>
   <option value="1">Yes</option>
</param>
 
Save the file. Users can now set if they want to use the messaging plugin and if they want to receive an Email when they receive a message.

Using the component

Using this component should be quite easy. Clicking on Inbox will bring you to the Inbox, and to send a message, you have to click on New Message. To view a message in the Inbox, click on that message. It should now appear on the container under the message box. To send a same message to multiple users, separate the users with a comma and a space (", "). To see your sent messages, click on the "Sent Mails" button. All messages you have sent that have not been deleted by the recipient will be shown. If there are more problems, you can post your question on the support forum (it is necessary to log in to post on the forum).

BBcode and emoticons

BBcode (BulletinBoard Code) is a secure way to allow formatting in messages. Here is the code and the effect:

Wanted effect
BBcode
Sample result
Bold text
[b]Text[/b]
Text
Italic text
[i]Text[/i]
Text
Underlined text
[u]Text[/u]
Text
Link
[url]http://www.joomla.org/[/url]
http://www.joomla.org/
Costumized link
[url=http://www.joomla.org/]Joomla[/url]
Joomla
Image
[img]http://www.joomla.org/...Thumbnail.png[/img]
Joomla logo
Quote
[quote]Quoted text[/quote]
To quote:
Quoted text
Code
[code]Code sample[/code]
Code sample
Text with a different size
[size=24]Textsize = 24px[/size]
Textsize = 24px
Text with a different color
[color=red]Red text[/color]
or
[color=#FF0000]Red text[/color]

Red text



The component now also supports emoticons:


Symbol
Result
O:)
O:)
:)
:)
:(
:(
;)
;)
:P
:P
B)
B)
:D
:D
:[
:[
:O
:O
:'(
:'(
:\
:\
*JOKINGLY*
*JOKINGLY*
:!
:!
*STOP*
*STOP*
@}->--
@}->--
*THUMBS UP*
*THUMBS UP*
*DRINK*
*DRINK*
*HELP*
*HELP*
%)
%)
*OK*
*OK*
*SORRY*
*SORRY*
*BRAVO*
*BRAVO*
*LOL*
*LOL*
*NO*
*NO*
*CRAZY*
*CRAZY*
*YAHOO*
*YAHOO*
*YES*
*YES*
*WALL*
*WALL*
*WRITE*
*WRITE*
*SCRATCH*
*SCRATCH*

Uninstalling the component

To uninstall the program, click on the "Install/Uninstall" button in the extensions menu. Go to the "Component" tab and click the radio button of the Messaging extension. Now click on the "Uninstall" button. The program is uninstalled.

Warning!! Doing this will delete all messages. If you don't want to lose all messages, read the following chapter.

Backing up the data of the component

If you want to install a new version of the component without losing all messages, you have to use the Messaging Backup component. You download it in the download section of this site. Install it as a normal program on Joomla. Then go to Components->Messaging Backup. Click on the export button. It should now show a confirmation that the messages have been saved to a file. You can remove the old version of the component and install the new one now. When you've done this, go to Components->Messaging Backup again. Now click on the import button. The file which saved the backup data on the server will be deleted now to protect your privacy and the messages will be put back in the database. Enjoy the new version of the component!!!


Note that the bloc below is not a demo of the component (coming soon), it's for comments!


Comments
Search RSS
Code problem
Nicky (124.179.131.xxx) 14-11-2011 07:01:20

Hi I have this error in the admin componant window

Notice: Undefined index:
nameSuggestion in /clientdata/zeus-dynamic-1/g/a/gamechasers.com.au/
www/joomla/administrator/components/com_messaging/ models/message.php on line
37

Notice: Undefined index: sendNotify in
/clientdata/zeus-dynamic-1/g/a/gamechasers.com.au/
www/joomla/administrator/components/com_messaging/ models/message.php on line
37

Notice: Undefined index: limitAddress in
/clientdata/zeus-dynamic-1/g/a/gamechasers.com.au/
www/joomla/administrator/components/com_messaging/ models/message.php on line
37

And when I go to read a message I have this error

Notice: Undefined
property: MessagesModelMessages::$baseurl in
/clientdata/zeus-dynamic-1/g/a/gamechasers.com.au/
www/joomla/components/com_messaging/models/message s.php on line 236
new error
Nicky (124.179.131.xxx) 14-11-2011 07:03:59

When I replied to a message i got this error

Notice: Undefined property:
MessagesModelMessages::$baseurl in
/clientdata/zeus-dynamic-1/g/a/gamechasers.com.au/
www/joomla/components/com_messaging/models/message s.php on line 236
Sander (SAdministrator) 19-11-2011 16:46:46

Hi,
See the following forum page:
http://www.thetricky.net/forum?itemid=328&func=vie w&id=96&catid=10#96
Spelling
Steve Goode (94.168.90.xxx) 21-09-2011 19:08:11

Sorry, I added this against a comment lower down but realise that I should have
added it as a new question.

I have found the spelling mistakes
"recieve" and "separete" in the module and I would like to know
where I need to go to change them.

Thanks
Steve
Sander (SAdministrator) 21-09-2011 20:43:29

Hi,

The easiest way is to edit the language files of the component. You can
find them at /components/messaging (I think, I haven't used Joomla for a while).
Look for a file called "en-GB.com_messaging.ini" (or a variant of the
name if you want to change another translation). You can just edit the values in
there.
Spelling
Steve Goode (94.168.90.xxx) 21-09-2011 21:24:49

Perfect, thank you.
"Settings for the users" not visible
Muadib (94.254.38.xxx) 29-05-2011 14:24:58

Hello!

Thanks for the great work.

I cannot seem to make visible the 2 extra
user choices you described in the "Settings for the users" Section.


How can I enable the function for the users?

All best,
/Kle
Sander (SAdministrator) 29-05-2011 16:41:35

Thanks!

Are you sure you've installed the latest version? If not, try to
migrate to the latest version.
Kle (94.254.38.xxx) 29-05-2011 22:40:40

I downloaded it today! Should I do anything more that I missed doing?
Sander (SAdministrator) 29-05-2011 22:46:11

Have you installed the UserMeta plugin and changed the user.xml file? (this
plugin doesn't come bundled with the compenent as Joomla has no way to do this).
Kle (82.99.7.xxx) 30-05-2011 12:07:02

Yes, exactly as you describe in the "Settings for the users" section.
Sander (SAdministrator) 30-05-2011 15:25:15

Hmm, strange. Could you go to the forums ( link:http://thetricky.net/forum?itemid=328&func=v iew&catid=9&id=605)?
Kle (94.254.38.xxx) 30-05-2011 20:03:47

Yes, I will. Btw, the website is http://stockholm.thezeitgeistmovement.se

My
username is 'muadib'.
undefined index
alberto (151.59.4.xxx) 07-01-2011 16:54:22

Hi Henry,
I just installed your messaging component and followed your
instructions to avoid the "undefined index" problem but ... the problem
is still there. The table jos_messaging seems to have been created as per your
example but.... keine Ahnung !
Thanls for your help.
Alberto

Here are the
messages:

Notice: Undefined index: nameSuggestion in
/var/www/web312/html/components/com_messaging/mode ls/messages.php on line
286

Notice: Undefined index: sendNotify in
/var/www/web312/html/components/com_messaging/mode ls/messages.php on line
286

Notice: Undefined index: limitAddress in
/var/www/web312/html/components/com_messaging/mode ls/messages.php on line 286
Sander (SAdministrator) 07-01-2011 17:46:50

This seems to come from a small mistake in the models/messages.php file. Could
you try replacing line 280:

$query = ";SELECT groupName, messageLimit FROM
#__messaging_groups";

By:

$query = "SELECT groupName, messageLimit
FROM #__messaging_groups LIMIT 0,7";

Edit: Both pieces of code should be
one line. The comment system breaks it up in two lines.
Delete messages from SENT BOX?
Museum of the American Gangste (24.189.103.xxx) 01-06-2010 19:43:31

Hello- great component... just one question: is there a way for users to delete
messages from their sent box? This has been frequently
requested.

THANKS
http://moagnyc.org
Sander (SAdministrator) 01-06-2010 19:53:11

As this component is as simple and light as possible, I'm not planning on adding
this. As said before, the sent box is simply a way to view all messages that
still exist with you as sender. The deletion is done by the recipient. The goal
of the sent box is to make it possible to check easily what you wrote just after
you sent it, it wasn't meant to be used as an archive.
Thank you for your quick reply...
museum of the american gangste (24.189.103.xxx) 01-06-2010 20:01:30

... sounds good to me.

Regards,
http://moagnyc.org
Users
moose (174.24.58.xxx) 13-05-2010 00:13:50

Is there a way to hide administrators and super administrators from the list?
Can we have sorting.....
Sijo (114.143.127.xxx) 13-04-2010 08:47:16

This is a really great extension...I think there should be an option to sort by
sender or by date...
Delete
Ron (124.191.33.xxx) 24-11-2009 13:09:33

Sorry, works fine I should have searched the forum first. Great message
system
Thank you

Ron
No delete for sent messages
Ron (124.191.33.xxx) 24-11-2009 13:00:47

Everything works fine but no way of deleting sent messages. Should there be a
"delete" option for sent?

Thanks
Ron
change seen column from 0 on new to1 on new
Matthew (68.5.51.xxx) 02-10-2009 00:40:01

Hi Guys,

I'm doing a sum query and I would like the seen column to express a
"1" when the message has not been seen and a "0" when it has. I
have been looking all through the code but have not been able to solve this
problem. Is there a way solve this problem I am having?

Thanks,

Matt
henry (93.72.88.xxx) 15-05-2009 15:14:28

I just installed Joomla link:http://rapid4me.com/?q=joomla+tutorial yesterday, and I was messing
around with it for a while, got it to look exactly how I wanted it,
and now today I'm getting the message "PLEASE REMEMBER TO
COMPLETELY REMOVE THE INSTALLATION DIRECTORY.".....I've removed the
directory since yesterday. Am I missing something?
Sander (SAdministrator) 08-09-2009 21:34:46

I think you aren't posting in the right place. Try to go to www.joomla.org to
get more information.
Undefined index errors
alex (94.162.123.xxx) 27-04-2009 20:11:34

hello i keep receiving the following errors when accessing the inbox:
Notice:
Undefined index: nameSuggestion in E:\Programmi\Apache Software
Foundation\Apache2.2\htdocs\joomla\
;components\com_messaging\models\messa ges.php on line 286

Notice:
Undefined index: sendNotify in E:\Programmi\Apache Software
Foundation\Apache2.2\htdocs\joomla\
;components\com_messaging\models\messa ges.php on line 286

Notice:
Undefined index: limitAddress in E:\Programmi\Apache Software
Foundation\Apache2.2\htdocs\joomla\
;components\com_messaging\models\messa ges.php on line 286

please
help!!
Sander (SAdministrator) 08-09-2009 21:37:01

Hmm, try looking here: http://www.thetricky.net/forum?itemid=328&func
=view&id=120&catid=9#187
words
founder (76.215.146.xxx) 20-02-2009 23:21:11

1. In "Settings for the users" the word "receive" is misspelled.
The rule we learn is "i before e, except after c".
2. In the following
section, it should be "separate". The rule we learn is that "There
is 'a rat' in 'separate'!
Sander (SAdministrator) 21-02-2009 09:31:51

Ah well, nobody is perfect. But it should be right now.
Spelling
Steve Goode (94.168.90.xxx) 21-09-2011 19:06:02

Hi,

I have the spelling mistakes identified above but I am unsure as to where
I can change them?

Thanks
Steve
Only registered users can write comments!

3.23 Copyright (C) 2007 Alain Georgette / Copyright (C) 2006 Frantisek Hliva. All rights reserved."