Mambo Documentation Resources

[kenmcd]

Mambo Documentation Resources
1 of 2 - July 2005


First - A big THANK YOU to all the authors.

Note: This post has only Online, PDF, and DOC format documentation.
Page Down to multimedia (Flash) demos and tutorials.


New Mambo book: Building Websites with Mambo Aug 2005 NEW!
Packt will be donating a percentage royalty to the Mambo project. MORE



Official Manuals
-----------------------

help.mamboserver.com
Mambo Help site (documentation) 4.5.2/4.5.3

help.mamboserver.com Site Map
Installation Manual 1 of 4
Administrator Manual 2 of 4
Administrator Manual (continued) 3 of 4
Developer Manual 4 of 4

API
Mambo 4.5.2 API online 2005
Mambo 4.5.2-API-Diagrams ZIP, 279 KB
Mambo 4.5.2-API-Html ZIP, 1.9 MB
Mambo 4.5.1 API online Sep 2004

Mambo 4.5.1 Official Manual
Mambo 4.5 Manual 1.0.1.PDF ZIP, 1.52 MB
Mambo 4.5 Manual 1.0.1.RTF ZIP, 1.47 MB

Mambo Developer's Manual v4.5.1 DRAFT 53 pgs., 2004, PDF, 118 KB

MamboForge User Guide PDF, 151 KB

Developer Manual
Roadmap for Version 4.5 and 5.0

Translating Mambo 12 pgs., PDF, 587 KB


Installation
---------------------

forum.mamboserver.com
- Installing Mambo Server on Windows
- Absolute Path - How to Determine


Administration
---------------------

NetshineSoftware.com
Mambo Tutorials
- Mambo Tutorial - Quick Start Guide (4.5.2.1) 23 pg, Feb 2005, PDF, 873 KB
- Mambo Tutorial - Quick Start Guide (4.5.2.1) 23 pg, Feb 2005, DOC, 762 KB
- Mambo Tutorial - Quick Start Guide (4.5.1a) 24 pg, Dec 2004, PDF, 2.3 MB
- Mambo Tutorial - Quick Start Guide (4.5.1a) 24 pg, Dec 2004, DOC, 2.6 MB
- Mambo-phpShop Tutorial v1.2 29 pg, Jan 2005, PDF, 1.6 MB
- Mambo-phpShop Tutorial v1.2 29 pg, Jan 2005, DOC, 995 KB
- Mambo Glossary of Terms

Scotweb.com
Mambo Documentation
- Mambo 4.5.2 User Manual 37 pg, 2005, PDF, 2.6 MB
- Mambo 4.5.1 User Manual 35 pg, 2004, PDF, 4.1 MB
- Mambo 4.0 User Manual 40 pg, 2003, PDF, 418 KB
- Mambo Tips and Tricks 2 pg, 2005, PDF, 137 KB

MamboTemplates.com
- Modifying the 'Read On...' Link on News Items Jul 2003
- Remove the Date Stamp on Front Page Items Jul 2003
- Search Engine Friendly URL's May 2003
- Defining the Absolute Path Apr 2003

forum.mamboserver.com
- Anna's Mambo Tips May 2005
- Mambo Structure/Navigation 101 Aug 2004
- How to Move Your Mambo Site Jan 2005
- How to insert static images inside a module Jun 2005
- Making a Fully Customizable FORM Jun 2005
- Walkthru for a Module type content and a Wrapper type Form Jun 2005

Allmambo.com
- Simpleboard Installation 3 pg, Jul 2004
- Wrapper Tutorial 2 pg, Aug 2004

MamboHacks.com
- Installing Mambo-SMF Integration Apr 2005
- Change Dark Background in TinyMCE Mar 2005
- Backing Up Remote MySQL Database to Your Local Desktop Mar 2005
Includes MySQL Administrator screenshots.

DevBay.com
- Adding Page Titles to Mambo TOC 2005

JLLeBlanc.com
Joseph LeBlanc's Mambo Resources
- Bare Minimum Mambo Component
- Add To My Yahoo Module and Tutorial
- Daily Message with E-mail
- Daily Message with HTML Editors & Dates
- The Daily Message Mambo Component Tutorial


Templates and CSS
---------------------------

FrontzWare.com
Mambo 4.5.2 - CSS style - alphabetical sort cross referenced by file Jul 2005 New!

MamboTheme.com
Understanding Mambo CSS in 5 Minutes Jun 2005
How to make rounded module like Mamboserver.com (Part 1) Jun 2005
How to make rounded module like Mamboserver.com (Part 2) Jun 2005
Mambo Layout Jun 2005
Excellent annotated screenshots.

Arketec.com
Rounded Corners for Mambo (patTemplate) Jun 2005

DevBay.com
Mambo Template Explained 4 pages, Jan 2005
Very Good.

MamboNotes.com
Mambo CSS Quick Reference Feb 2005

MamboSolutions.com
Creating Mambo 4.5.1a Templates in Dreamweaver Dec 2004
Includes screenshots.

MamboSphere.com
Editing and Identifying CSS Classes LIVE with Firefox Oct 2004

MamboOS.de
Mambo CSS Guide 4.5.0
CSS classes annotated on screenshots.

Allmambo.com
MOS Templates 101 14 pages, Jun 2004
MOS Template Conversion 3 pages, Jun 2004

ChurchMinistriesOnline.com
Template Creation 7 pages, Oct 2004
CSS Overview 7 pages, Oct 2004

YaTienesWeb.com
CMTs, CSS, XHTML, Menus, and more . . .
Individual module styling

help.mamboserver.com
Mambo File and Function Reference
patTemplate

forum.mamboserver.com
patTemplate


Components
----------------

DevBay.com
Mambo Component Tutorial 7 pg, Jan 2005
Very Good. Comprehensive.

JLLeBlanc.com
Bare Minimum Mambo Component

help.mamboserver.com
Developer Manual
Writing a Simple Component
Tutorials
Components


Modules
------------------

help.mamboserver.com
Developer Manual
Writing a Simple Module
Tutorials
Modules

MamboDev.com
Putting a Module in a Custom Module Position


Mambots
------------------

forum.mamboserver.com
How to Code Parameters into Mambots

help.mamboserver.com
Developer Manual
- 4. Mambots


Security
------------------

forum.mamboserver.com
- IP site access control via .htaccess
- Protecting Mambo Sites from Hackers
- Mambo security components

MamboForge.net
Mambo Security
- Securing Mambo Open Source CMS v0.4 17 pages, PDF, 99 KB
Mambo-Lock
- Read Me


Page Down to multimedia (Flash) demos and tutorials.

.

[kenmcd]

Mambo Documentation Resources
2 of 2 - July 2005

Note: This post has only multimedia (Flash) demos and tutorials.
Page Up to post #1 for online, PDF, and DOC format documentation.


Multimedia Tutorials (Flash)
-----------------------------------------

MamboTutorials.com (28)
Live Tutorials Menu
Chapter 1 - Beginning
- Installing 8.5 MB
Chapter 2 - An Overview
- Administration Overview 706 KB
- Administration Login 1.1 MB
- Check In/Out 854 KB
- User Groups & Access Controls 1.2 MB
Chapter 3 - Home
- Private Messaging 405 KB
- Control Panel 580 KB
Chapter 4 - Site Management
- Global Configuration 1.7 MB
- Language Manager 1.5 MB
- Statistics 1.3 MB
- Template Manager 3.4 MB
- Trash Manager 856 KB
- Mass Email 520 KB
Chapter 5 - Menu Manager
- Menu Manager 3 MB
Chapter 6 - Content Management
- Section Manager 663 KB
- Category Manager 753 KB
- Adding Content 2.2 MB
- Attributes 2 MB
Chapter 7 - Components
- Overview: Installation & Removal 1.8 MB
- Banners 1.6 MB
- Contacts 1.6 MB
- Media Manager 2.7 MB
- News Feeds 1.8 MB
- Web Links 2.2 MB
Chapter 8 - Modules
- Overview: Install/Uninstall 1.2 MB
- Archives 1.1 MB
- Login Form 799 KB
- Newsflash 1.3 MB
Voice narration.

Scotweb.com (8)
Mambo CMS Flash Tutorials 4.5.1a, 2004
- Add Content 872 KB
- Add Section 427 KB
- Create Module 641 KB
- Assign Template 482 KB
- Add Wrapper 2.1 MB
- Link URL 837 KB
- Link Component 1.1 MB
- Add Category 407 KB

Mamboportal.com (2)
Mambo 4.5.1 Articles
- How to Create Submenus 4.5.1, 5.5 MB, Oct 2004
- How to Create HTML Modules 4.5.1, 1.5 MB, Oct 2004
Voice narration.

MamboInfo.com (18)
Getting Started
- Step 1 - Change Your Administrator Username and Password 142 KB
- Step 2 - Change Your Site Template 199 KB
- Step 3 - Add Components and Modules to Your Site 296 KB
- Step 4 - Change/Update Content on Your Site 225 KB
Free Mambo Tutorials
- Update Content 225 KB
- Update Contact Us 1.2 MB
- Add a WYSIWYG Text Editor 296 KB
- Add Images to the Media Manager 163 KB
- Assign Different Templates to Different Menu Items 481 KB
- Change Module Positions 220 KB
- How to Upload Files via FTP 315 KB
Member Tutorials (all were available without membership)
- Add a Quick Download MamBot 276 MB
- Site Sync from MSAS (local site) to Web Server 598 KB
- Managing Multiple Sites in MSAS 1.7 MB
- Install and Configure Jobline 446 KB
- DocMan Configuration 229 KB
- DocMan Add Files and Documents 542 KB
MSAS = Mambo Stand Alone Server

Mech7.net (1)
Mambo v4.5.1a Installation 1.2 MB, Jan 2005
Includes using phpMyAdmin to setup database.

DemoDemo.com (16)
Mambo Tutorials 4.5.2
- Managing Global Configuration 344 KB
- Editing Your Admin Profile 237 KB
- Managing Templates 422 KB
- Managing Sections 554 KB
- Managing Categories 552 KB
- Using Menu Manager 646 KB
- Managing Users 368 KB
- Adding New Content 436 KB
- Managing Static Content 427 KB
- Using Trash Manager 300 KB
- Managing Media 378 KB
- Using Poll Manager 326 KB
- Sending Mass Email 242 KB
- Installing a Language 271 KB
- Managing Banners 613 KB
- Using Contact Manager 496 KB

TutorialCenter.net (27)
Mambo Tutorials 4.5.1
- Install Mambo 4.5.1a 1.1 MB
- Mambo Overview 840 KB
- Global Configuration 679 KB
- Languages 841 KB
- Media Manager 501 KB
- Preview 475 KB
- Statistics 471 KB
- Template Manager 964 KB
- Trash Manager 756 KB
- User Manager 1.5 MB
- Menu Management 627 KB
- All Content Items 1.1 MB
- News Flash 536 KB
- Frontpage Manager 353 KB
- Static Content 883 KB
- Archive Manager 451 KB
- Section Manager 491 KB
- Category Manager 437 KB
- Install a component 875 KB
- Banners 622 KB
- Contacts 1.1 MB
- Newsfeeds 536 KB
- Polls 487 KB
- Web Links 762 KB
- Modules 610 KB
- Mambots 547 KB
- System 680 KB
Unfortunate distracting menu animation.


------------------------------------

Note: This post has only multimedia (Flash) demos and tutorials.
Page Up to post #1 for online, PDF, and DOC format documentation.

Please post any broken links or additions.
Some sites with duplicate content or anti-link policies were omitted.

Click Here to Subscribe for notification of new documentation.

.

[kenmcd]

help.mamboserver.com Site Map
Installation Manual
1 of 4


- Installation Manual
- - Preface
- - System Requirements
- - Configuring MySQL
- - Getting the Files
- - Installing Locally
- - Installing Remotely
- - Browser Installation
- - Manual Installation
- - Configuration File
- - Upgrading 4.5(1.0.9) to 4.5.1
- - Quick Fix for Old Modules
- - Getting Mambo from the CVS

- - Upgrading to Mambo 4.5.2
- - What does Mambo need to run?

=========

Overall Help Site Map
- Official Manuals
- - Installation Manual (reference)
- - Administrator Manual (reference)
- - User Manual (How to Use Mambo) planned, none yet
- - Developer Manual (reference)
- - Documentation Guide Doc Writer - guidelines for authors
- Tutorials
- - Currently there are no tutorials on the help site.
- Help Site Tools
- - Home
- - Search Box on every page
- - Advanced Search Search
- - Site Map none
- - How to Contribute Get Involved
- - About Us (the Documentation Team) none
- - Doc Team Login

[kenmcd]

help.mamboserver.com Site Map
Administrator Manual
2 of 4


- Administrator Manual
- - Preface
- - Chapter 1: Introduction
- - Chapter 2: Administrator Overview
- - Chapter 3: Global Configuration
- - Chapter 4: Language Manager
- - - Install/Uninstall a Language File or Template
- - - Language Manager
- - Chapter 5: Media Manager
- - - Media Manager
- - Chapter 6: Site Preview
- - Chapter 7: Site Statistics
- - - Search Engine Text
- - Chapter 8: Managing Templates & Modules Positions
- - - Install/Uninstall a Language File or Template
- - - Template Manager
- - - Module Positions
- - Chapter 9: Trash Manager
- - Chapter 10: Managing Users
- - - User Manager - Add or Edit Users
- - - Users: Access Control Levels (ACL)
- - Chapter 11 : Managing Your Menus
- - - Module: Main Menu and other Menus
- - - User Menu
- - - Menus: New Menu Item
- - - - Content
- - - - Blog - Content Category
- - - - Blog - Content Category Archive
- - - - Blog - Content Section
- - - - Blog - Content Section Archive
- - - - Link - Content Item
- - - - Link - Static Content
- - - - List - Content Section
- - - - Table - Content Category
- - - - Component
- - - - Component
- - - - Link - Component Item
- - - - Link - Contact Item
- - - - Link - Newsfeed
- - - - Table - Contact Category
- - - - Table - Newsfeed Category
- - - - Table - Weblink Category
- - - - Link
- - - - Link - Component Item
- - - - Link - Contact Item
- - - - Link - Content Item
- - - - Link - Newsfeed
- - - - Link - Static Content
- - - - Link - URL
- - - - Miscellaneous
- - - - Separator / Placeholder
- - - - Wrapper
- - Chapter 12: Managing the Home Page & the Frontpage Component
- - - FrontPage Component Menu Item
- - Chapter 13: Creating/Editing and Managing Content
- - - Content Items Manager
- - - Static Content Manager
- - - Frontpage Manager
- - - Archive Manager
- - Chapter 14: Managing Components
- - - Install/Uninstall Components, Modules and Mambots
- - - Banner Manager
- - - Banner: Client Manager
- - - Contact Manager
- - - Category Manager
- - - News Feeds Manager
- - - - Link - Newsfeed
- - - - Table - Newsfeed Category
- - - - Module: User (Custom & RSS Feeds)
- - - - News Feeds and Contact Category Manager
- - - - Content Items Manager
- - - Poll Manager
- - - Syndication Settings
- - - Web Link Manager
- - - - Web Link Manager : New / Edit

[kenmcd]

help.mamboserver.com Site Map
Administrator Manual (continued)
3 of 4


- Administrator Manual (continued)
- - Chapter 15: Managing Modules
- - - Module Manager
- - - - Install/Uninstall Components, Modules and Mambots
- - - - Modules: New
- - - - Modules: Edit
- - - - Module: Positions
- - - Module: Archive
- - - Module: Banners
- - - Module: Latest News
- - - Module: Login Form
- - - Module: Main Menu and other Menus
- - - - User Menu
- - - Module: Newsflash
- - - Module: Pathway
- - - Module: Polls
- - - - Poll Manager: New / Edit
- - - Module: Popular
- - - Module: Quick Icons
- - - Module: Random Image
- - - Module: Related Items
- - - Module: Sections
- - - Module: Statistics
- - - Module: Syndicate
- - - Module: System Message
- - - Module: Template Chooser
- - - Module: Toolbar
- - - Module: Unread Messages
- - - Module: User (Custom & RSS Feeds)
- - - Module: Who's Online
- - - Module: Wrapper
- - Chapter 16: Managing Mambots
- - - Mambot Manager
- - - - Install/Uninstall Components, Modules and Mambots
- - - - Mambots: New / Edit
- - - Mambot: Code Support
- - - Mambot: GeSHi
- - - Mambot: Email Cloaking
- - - Mambot: Legacy Mambot Includer
- - - Mambot: Load Module Positions
- - - Mambot: MOS Pagination
- - - Mambot: MOS Rating
- - - Mambot: No WYSIWYG Editor
- - - Mambot: FCK Editor
- - - Mambot: MOS Image Editor Button
- - - Mambot: MOS Pagebreak Editor Button
- - - Mambot: Search Categories
- - - Mambot: Search Contacts
- - - Mambot: Search Content
- - - Mambot: Search Newsfeeds
- - - Mambot: Search Sections
- - - Mambot: Search Weblinks
- - - Mambot: SEF (Search Engine Friendly)
- - - Mambot: TinyMCE WYSIWYG Editor
- - Chapter 17: Installers
- - Chapter 18: Messages
- - - Messages Configuration
- - - Messages Inbox
- - - Mass Mail Users
- - Chapter 19: Global Check-in, Clean Cache
- - Chapter 20: General Help, System Info
- - Chapter 21: All About Parameters

[kenmcd]

help.mamboserver.com Site Map
Developer Manual
4 of 4


- Developer Manual
- - Preface
- - - i. Preface
- - - ii. Preamble
- - 1. Basic Templating and Site Design
- - - Templating Overview
- - - The Layout File
- - - Style Sheets
- - 2. Advanced Templating
- - - Overview
- - - Administrator Templates
- - - Function Reference
- - - Template Standards
- - 3. Modules
- - - Writing a Simple Module
- - 4. Mambots
- - - Mambots - Overview
- - - Writing a Mambot
- - - An onSearch Mambot
- - - An onPrepareContent Mambot
- - - Editor Mambots
- - - Using Parameters within a Mambot
- - - Extending Mambots
- - - Legacy Mambots - The Old Way
- - 5. Components
- - - Chapter 5. Components
- - 6. Language
- - - Chapter 6. Language Support
- - 7. Packaging
- - - Chapter 7. Packaging Custom Work
- - 8. Access Control
- - - Chapter 8. Access Control
- - 9. API Reference
- - - Chapter 9. API Reference
- - Appendix
- - - A. Updates for 4.5.1
- - - B. Using Parameters
- - - C. mosHTML Reference
- - - D. Code and Commenting Standards
- - - E. Porting MiniXML to the DOMIT Library
- patTemplate
- - Preface
- - - Introduction
- - - patTemplate Overview
- - patTemplate Tags
- - - Tmpl Tag
- - - Sub Tag
- - - Link Tag
- - - Var Tag
- - - Comment Tag
- - Developer Reference
- - - Dot Syntax
- - - Reserved Variables
- - Customisation
- - - Directory and Class Structure
- - - Custom Modifiers
- - - Reading from any datasource
- - - Filters
- - - Using custom functions
- - - Caching
- - - Dumpers
- FAQ
- - How can I create lists with the result of a database query?
- - How can I create tables with several rows and columns?
- - How can I hide parts of a page?
- - How do I build a drop-down menu witha database result?
- - Can I re-use templates in different pages?
- API Documents
- - Are there API Documents
- - - help.mamboserver.com/api/
- - - mamboforge.net
- Roadmap for Version 4.5 and 5.0

[kenmcd]

Absolute Path - How to Determine

When uploading from a local testing server to a web server the absolute path also needs to be updated.
The absolute path is the directory where Mambo is located on the server hard drive.
This small PHP script will report the actual absolute path.

serverpath.php

PHP Code:

<?php
echo $_SERVER['DOCUMENT_ROOT'];
?>

Place (upload) this script in the directory where you want to find the absolute path.
Point a browser to this script and the path will appear in the browser.

On a Linux server, that will give you something like this example:
/var/www/example.com/httpdocs

In the Mambo configuration.php file, the above example would look like this:
$mosConfig_absolute_path = '/var/www/example.com/httpdocs';

[kenmcd]

Mambo RSS Feeds
Add these feeds to your reader or web site.
Note: right click on feed link to save


Official Mambo Sites

www.mamboserver.com - Newsflash
RSS 0.91 RSS 1.0 RSS 2.0 Atom 0.3 OPML

news.mamboserver.com - Newsflash
RSS 0.91 RSS 1.0 RSS 2.0 Atom 0.3 OPML

help.mamboserver.com - Newsflash
RSS 0.91 RSS 1.0 RSS 2.0 Atom 0.3 OPML

forum.mamboserver.com - All New Posts
RSS 0.91 RSS 2.0 selecting specific forums

MamboForge.net - Project News
RSS 1.0


Community Mambo Sites

FreeMambo.com - Newsflash
RSS 0.91 RSS 1.0 RSS 2.0 Atom 0.3 OPML
Consolidated news on Mambo components, modules, mambots, and templates.

Note: will add more community sites as discovered.


News Feed URLs for Any Mambo Site
Add the following to the Mambo site base URL:

RSS 0.91
/index2.php?option=com_rss&feed=RSS0.91&no_html=1

RSS 1.0
/index2.php?option=com_rss&feed=RSS1.0&no_html=1

RSS 2.0
/index2.php?option=com_rss&feed=RSS2.0&no_html=1

Atom 0.3
/index2.php?option=com_rss&feed=ATOM0.3&no_html=1

OPML
/index2.php?option=com_rss&feed=OPML&no_html=1

Example RSS 2.0 URL:
ht#p://www.example.com/index2.php?option=com_rss&feed=RSS2.0&no_html=1


To comment on this post: Mambo Documentation Resources Discussion

[kenmcd]

How to Check-out Mambo from CVS on Windows
Using TortoiseCVS

TortoiseCVS is an extension for Windows Explorer that makes using CVS easy.

Install TortoiseCVS and Set-up Download Directory

Obtain TortoiseCVS for Windows
Info: http://www.tortoisecvs.org/
Download: http://www.tortoisecvs.org/download.shtml

Install TortoisCVS.
This will create new right-click menus in Windows Explorer.

Create a directory where you want to download Mambo.
I use ...\My Documents\Download\CVS\Mambo\


Start Tortoise CVS and Configure for Mambo

Right-click on this new Mambo directory, select CVS Checkout from this menu.

This will open TortoiseCVS. (See Figure 1)
These instructions are to do an anonymous checkout.
Enter the following info in the boxes:
- Protocol: Password server (:pserver:)
- Server: cvs.mamboforge.net
- Repository folder: /cvsroot/mambo
- User name: anonymous
- Module: 4.5.x

These are the settings to checkout Mambo v4.5.3 - Module: 4.5.x.


Figure 1 - Configure for Mambo


Checkout - for working on the module (See Figure 2)
This setting will checkout the Mambo module and also track the version
of each individual file. There will be a CVS folder in every download
folder. These folders are used to track the file versions.


Figure 2 - Checkout for working on the module


Click OK . . . and files will start downloading. (See Figure 3)
You will see all the files being downloaded in a list.
Only changed files are downloaded using this method (first time = all files).
The green lines with a leading "U" (for update) are the new files.


Figure 3 - Files downloaded


Export - for making a software release (See Figure 4)
This method removes all the CVS tracking folders.
All files are downloaded, not just changed files.
Pick a folder name where you want the files downloaded.


Figure 4 - Export for making a software release


Click OK . . . and files will start downloading. (See Figure 5)
This time all files are downloaded.


Figure 5 - Export for making a software release file list


You will now have the most current files.

ChangeLog
You will find the ChangeLog in:
\My Documents\Download\CVS\Mambo\4.5.x\CHANGELOG
It is a text file, open with any editor.

ToDo List
Recently added ToDo list - helps all know status & direction.
You will find the ToDo list in:
\My Documents\Download\CVS\Mambo\4.5.x\TODO
It is a text file, open with any editor.

Available branches/modules:
- Module: 4.5.x - Mambo 4.5.3 branch
- Module: 5.0 - Mambo 5.0 branch
- Module: 4.5 - Mambo 4.5 branch, this is the current 4.5.2.x release
To check-out a different branch, just change the Module setting (Figure 1).

Note: These are development builds, NOT releases. (4.5.x and 5.0)
Do not download and install on a production server and then start complaining about problems.
They do run and are fun to play with on a testing server, but bugs are expected.

Instructions for Linux are here: Getting Mambo from the CVS

There is another program for Windows - WinCVS.
It is more powerful, but much harder to use.
To do a simple anonymous check-out, TortoiseCVS is much easier.

To comment on this post: Mambo Documentation Resources Discussion