Geeklog Plugins by Portalparts - www.portalparts.com
glMessenger plugin - version 1.9.5
Author: Blaine Lang < blaine@portalparts.com >
Current Maintainers: [Geeklog Community
Members](https://github.com/Geeklog-Plugins/messenger/graphs/contributors)
Date: June 8, 2020
Requires minimum Geeklog version 2.2.1.
This Geeklog plugin provides Private Messaging Functionality for your site members. New messages are received into
your inbox and users are sent a email notification to alert them unless they have disabled the user preference. Site
Administrators can also send out a broadcast message using the plugin.
Summary of features:
- Enables site members to easily send other site members messages
- Integrates seamlessly with the Forum Plugin to provide a 1-click feature to contact the posting member
- Provides an online Smilie adminitration feature for the site admin which is also intergrated with the Forum
plugin so you can easily extend and personalize the smilies emoticons available for private messages and forum
posts
- Online Budddy Admin tool so members can easily contact their favorite site members
- Ability to archive messages and view messages sent to other site members
- Site Admin can send out a broadcast private message but also members can enable the option to block broadcast
messages
- Integration with your member account profile
View additional details and screen snapshots here
Refer to the wiki on the www.portalparts.com site here for the latest and updated
documentation
Table of Contents
1) How to Install
You need to manually create the plugins program directories and copy the
files to their appropriate directories.
First time installing a plugin ? Suggest you review the Geeklog Plugin Installation Overview Reference
Step 1 - Restore the plugin Archive
- Uncompress the archive files into your <geeklog_dir>/plugins directory. It will create a messenger
subdirectory for the files.
Step 2 - Create the required plugin directories for the program files
- Create a directory called messenger under your public_html/admin/plugins directory
- Create a directory called messenger under your public_html directory
Step 3 - Copy the the required plugin files
You will be copying the files from the restored plugin files to the new directories you just created.
- Copy the files (contents) from the new plugin's admin directory to the messenger directory you just
created under your sites main public_html/admin/plugins directory
- Copy the files (contents) from the new plugin's public_html directory to the messenger directory you just
created under your sites main public_html directory
Step 4 - Copy the the required theme files
- Copy the directory called messenger and contents from the new plugin's theme files directory to your sites
theme's directory. Assuming your site is running the professional theme this would be public_html/layout/professional
directory where you would copy the messenger template theme files - creating the new messenger folder under public_html/layout/professional
Step 5 - Update your theme's style.css file
- Add the css styles from the file additional-messenger.css that is located under the plugin archive themefiles
directory. Add the new styles to the end of your site theme's style.css file. Assuming your site is
running the professional theme this would be public_html/layout/professional/style.cssfile.
Step 6 - Install the smilie images
Step 7 - Update or copy the lib-portalparts.php file
- The plugins from portalparts use a number of common functions that are placed in the lib-portalparts.php file.
Copy the file from the plugin archive to your system folder where there are other lib-xxxxx.php files
Step 8 - Run the plugin install
- Logged in as 'admin' you can access the installer from the plugin editor [admin -> plugins]
- If the files have been copied correctly in step 2 and 3, you will see the new plugin to be installed
Congratulations - The plugin is now installed and you should see Private Messages link in the users menu block
2) How to update from version 1.x
There are no database changes from earlier versions - just program file and template changes
Step 1 - Restore the plugin Archive
- Before restoring the archive, you may want to backup or rename the plugins config.php so it is not over-written.
You can then compare them after the update and re-apply your personal settings if you have changed them from the
defaults
- Uncompress the archive files into your <geeklog_dir>/plugins directory. You will need to replace all the
files
Step 2 - Restore the plugin Archive
Suggest you delete current files and copy over the new files
- Update all your sites main public_html/messenger files.
- Update all your sites main public_html/admin/plugins/messenger files.
- Update all your sites main public_html/layout/{theme}/messenger files.
Step 3 - Update or copy the lib-portalparts.php file
- The plugins from portalparts use a number of common functions that are placed in the lib-portalparts.php file.
Copy the file from the plugin archive to your system folder where there are other lib-xxxxx.php files
Step 4 - Run the plugin update
- Access the plugin update from the Plugin Editor. The plugin listing will show version 1.x is installed and that
an update is recommended. Using the Edit link by the plugin record, access the edit screen where there will now
be an update button. Pressing [Update] will update the plugin to the latest version
Congratulations - The plugin is now updated
3) Extending the User Profile and
Preferences
For updated installation notes on how to extend the user account preferences allowing a user to control the email
notification settings and add the Buddy Admin quick links to the member profile page, refer to the wiki on the
www.portalparts.com site here