|
This is the documentation for Mamblog 1.0 which describes how to set up the comments system and how to link to users blogs as well as some notes on how to administer the blogs.
Mamblog is a user blog system for Joomla It allows you to run a page where users can register and get their own blog page where they can add new blog entries without having to be editors.
Among the features are: Users can publish/unpublish/archive individual blog entries, set appearence attributes. No new or changed tables in Joomla, it makes use of the standard Joomla content sections. Admin can edit/delete all blogs from the administrator interface. Lots of configure options. Completely automatical installation. Several language files included: English, Swedish, Norwegian, Dutch, German (informal), Italian, Russian, Spanish, French.
Requirements
Mamblog is a component for Mambo 4.5.2.3 and Joomla 1.0.x
Mamblog requires PHP4 or above.
License
Mamblog is released under the GNU General Public License, a copy of this license should be included in the zip file and available for reading from the administrator page once the component has been installed.
Installation
Just install the component as according to the Joomla documentation, a menu item for the component will be created and published automatically. This means users of your site can start using the blog component as soon as you've installed the component.
Upgrade
If you already run Mamblog and want to keep all old entries you will have to do a manual upgrade. To do this you need to unzip the component file locally and then upload all the files to the correct directories in your Joomla installation via a FTP program. Take a look in the file mamblog.xml and you will see two sets of lines looking similar to this: "<filename>mamblog.php</filename>". All files in the first list will have to be uploaded into this directory:
components/com_mamblog/
The second set of files, which should be below the "<administration>" line, should be placed in this directory:
administrator/components/com_mamblog
In both cases you will have to make sure you keep the directory structure intact.
Usage
Once installed you will have a new menu option called Mamblog under the Components menu in the administrator page of Joomla. From this menu you can administer the component, read information, change the configuration etc.
How to link to specific blogs
You can reach the blogs of certain users by either of the following URL:s:
http://www.example.com/index.php?option=com_mamblog&task=show&action=user&id=89
http://www.example.com/index.php?option=com_mamblog&task=show&action=user&id=Username
Either use user id or username to link to a user.
How to link to the users own blog
The stable version of Mamblog 1.0 adds a user menu link to the users' own blog. If you don't want to re-install the component you can add this function yourself by adding the following as an url menu item:
http://www.example.com/index.php?option=com_mamblog&task=show&action=showmyblog
They can also get a link to their own archive, it is very similar and looks like this:
http://www.example.com/index.php?option=com_mamblog&task=show&action=showmyarchive
Important information on the Mamblog section
If name of the Mamblog section has been changed the blog entries won't be automatically removed if you delete the component. Don't add any categories either, it is unnecessary and might cause problems.
Write a blog entry
When Mamblog is installed a new entry called "Write a blog entry" is automatically added to your user menu and this is what users click on to add new entries. You can add this link anywhere on your site if you want, it looks like this:
http://www.example.com/index.php?option=com_mamblog&task=edit
Comment system support
To allow comments to blog entries you first have to install a separate comment system. Mamblog supports both AkoComment by Arthur Konze and the now obsolete ComboLITE/ComboMAX components by Phil Taylor.
AkoComment
Arthur Konze has created a very nice and feature rich comment component called AkoComment v2.00 which is available at Mamboportal.com. After you have downloaded and installed AkoComment you need to set the "Main Operating Mode" in the AkoComment Settings to "Choose from settings below" and select your Mamblog section from the available sections. You will also have to change the Mamblog configuration setting "Comment system to use" under Settings to "AkoComment" to enable the comments in Mamblog. Also make sure that you allow comments to blog entries, either by setting "Allow Comments" under Default Values, or "Let users set if comments are allowed?" under Settings, to "Yes".
ComboLITE/ComboMAX
These components are now unavailable but are still supported for those who already have it installed. When you have installed ComboLITE/ComboMAX you will have to change the configuration setting "Comment system to use" to "ComboLITE or ComboMAX" and make sure that the Default value is to allow comments, or that users can set if they want comments allowed. Note that this has not been tested recently since these components have been discontinued by the author.
Joomlaboard
If you want to use the Joomlaboard forum as a commenting system you must choose this option and also add the id of the forum comment threads will be created in in the Joomlaboard forum ID config option below.
Moderating blog entries
All blog entries will show up in the content section called Mamblog and can be listed and edited just as normal content. New blog entries should be added through the frontend though.
Listing Bloggers
Mamblog doesn't have any internal functionality to list bloggers, but you can use the excellent Userlist XTD component by Bernhard Zechmann which has support for Mamblog.
Information
If you have any bugs to report, or want to make a feature suggestion, or just want to inform me of your site running this component you can write about it on the forums at my development site which you can find at this address: Jx Developer
All components and modules I've released are available from that site so if you are looking for more Joomla enhancements, feel free to visit.
If you like this component you can encourage the development by donating a few dollars to me via PayPal on the address
This e-mail address is being protected from spam bots, you need JavaScript enabled to view it
About the Author
Mamblog was initially developed by Olle Johansson.
Find more Joomla components and modules on Olle Johanssons development site Jx Developer.
Credits
First of all I'd like to thank all of the Joomla Core Developers for giving away so much of their time to develop the best CMS there is to be found on the net.
I'd also like to thank all of those who develop components, modules, templates etc for Joomla, it's great to have such a wealth of addons to choose from.
All those who have reported bugs, given name suggestions as well as feature suggestions are also worth mentioning, without you guys it would be hard to develop anything.
Those who have helped translating the component deserve special thanks as well, these are: sokratex, Joris van den Wittenboer, Martin Frjdh, Vlad, dikud (from Russian Mambo translation team), Francesco, Frank D. Martnez, Julien Rey.
I'd especially like to thank Jan de Graaf since I've used some code from Simpleboard for this component and for sending in Joomlaboard comment functionality code.
David Hagman is the guy who has drawn the new logo for Mamblog, which is much appreciated.
Finally, I'd like to thank Syedur Islam for requesting the component and donating some money to get me going, without him the component would probably never have been finished.
Donjun (koolitz) and MM (Birks) who sent me some code to add a link for the comments made with the ComboLITE/ComboMAX component.
Gary who sent in a bug fix for the comments code.
A.Scott McCulloch who donated a license of Wysiwyg Pro so that I could make sure the support for it is working.
|
ive installed this 2 times bt its showing an
