# Mambots: New / Edit

The Mambots: New/Edit page lets you edit the Site Mambots.
Detailed functions for each default Mambot is provided below.
Toolbar Icons:
Save: Click to save the parameters entered and return to the Mambot Manager.
Apply: Click to save the parameters entered AND keep the same window open for editing.
Close: Click to cancel any modification just made and to close the window. Any modification is lost. The Mambot remains checked-in.
Mambot Details:
Name: Type the name of the Mambot as it will appear on the Site Mambots listing. This has no impact on your site.
Folder: This shows into which category the Mambot is placed.
Mambot file: This is the name of the Mambot file as it appears in the folder.
Order: Choose the order of the Mambot as listed in the Folder when filtering by category.
Access Level: Choose who will be able to view this content. Public, Registered or Special.
Published: Check the box to let the Mambot show on your site or provide the function it is designed to do.
Description: This is a short description on the Mambot's function.
Parameters:
If available, they will be displayed here.
Site Mambots provided in a default installation of Joomla:
MOS Image:
Usage: { mosimage }

This mambot replaces tag in content with specified images. You can insert as many of these tags as needed in your articles. To do this while creating or editing a content item, select the images on the "Image" tab under "MOSImage Control". The replacement of the tags will follow the order of the images in the "Content Images" box.
NOTE: The tag described above should have no space after "{" and before "}". It has been displayed with spaces here not to implement the function in this screen.

GeSHi:
This displays formatted code in content items based on the GeSHi highlighting engine.

This is to be considered as an enhanced version of mosCode, allowing the rendering of many different programming languages with color-highlighted code by specifying the to-be-used language.

Usage: Use the "pre" tag and add the programming language you want to use for highlighting purposes as a parameter. Example:

< pre lang="xml" >your code here ... < /pre >

The mambot version of the GeSHi highlight code comes with the following highlighters for the most common renders installed, ready to be used:

- CSS => use lang="css"
- Html4 Strict => use lang="html4strict"
- JavaScript => use lang="javascript"
- PHP => use lang="php"
- PHP Brief => use lang="php-brief"
- SQL => use lang="sql"
- XML => use lang="xml"

Should you need additonal languages, you may download the full package from the developer site: http://qbnz.com/highlighter/ which includes over 30 languages. You should then upload the required "newLanguage.php" from the package into your "\mambots\content\geshi\geshi" folder.

NOTE: As of 4.5.2.1, this bot seems to have an incompatibility with the Email cloaking mambot.

Legacy Mambot Includer:
This is support for outdated Joomla 4.5 mambots.
This Mambot is unpublished by default; should you experience disfunctions with a particular, older mambot, try to publish it.

Code Support:

This displays formatted code in content items. No syntax highlighting. Code presented in Courier.

Usage: { moscode }... { /moscode }

Example:
{ moscode }<body onload="winManage(850,700,true);"><a name="top"></a><div><div id="wrapper"></div></div>{ /moscode }
NOTE: The tag described above should have no space after "{" and before "}". It has been displayed with spaces here not to implement the function in this screen.

MOS Rating:
This will add the Voting functionality to Content Items.

NOTE: For this mambot's output to be visible, you must set "Item Rating/Voting:" to "Show"
through Site- > Global Configuration- > Content.
Users will then be presented with a rating system from 1 to 5 at the top of a full content item. They will be able to cast their vote (once).

Email Cloaking:
This hides all e-mails in content from spambots using javascript. It does not function for Link - URL Menu Items. By editing the mambot, you may select between 2 settings under Parameters -> Mode:

- Nonlinkable Text will display an email typed by the user as simple text (not linked)
- As linkable mailto address will display the email address as a link to send an email, using the specified address.

As of 4.5.2.1 these are the ways the address should be written:
1. In plain text: mail@mail.com
2. As a mailto: <a href="mailto:mail@mail.com">mail@mail.com</a>
Otherwise the cloaking prevents the address from being decrypted when calling the mailer.
As of 4.5.3 CVS, the mambot will accept:
<a href="mailto:mail@mail.com">Some text</a>
Load Module Positions:
This loads module positions within Content.
Usage: {mosloadposition user1} where 'user1' is one of the positions defined for your site through Site->Templates->Modules Positions.
This means you may load any module assigned to this position at this specific place into your Content without defining the position into the Template index.php file.
Parameters lets you choose a style of HTML code to insert the module:

- Wrapped by Table - Column
- Wrapped by Table - Horizontal
- Wrapped by Divs
- No wrapping, raw output

MOS Pagination:
This will add a Table of Contents functionality to a paginated item.
Usage: { mospagebreak } or { mospagebreak title=The page title } or { mospagebreak heading=The first page } or { mospagebreak title=The page title&heading=The first page } or { mospagebreak heading=The first page&title=The page title }
A new 'contenttoc' CSS class is used to display this Table of Contents.
NOTE: The tags described above should have no space after "{" and before "}". They have been displayed with spaces here not to implement the function in this screen.
Parameters:
Site Title: This lets you add or not the mambot title and heading attributes to the Site Title Tag.
No WYSIWYG Editor:
This loads a basic text entry field wherever you may edit content.
TinyMCE Editor:
This loads this default WYSIWYG Editor wherever you may edit content.
MOS Image Editor Button:
This provides the button to insert the MOS Image tag into content edit box.
MOS Pagebreak Editor Button:
This provides the button to insert the { mospagebreak } tag into content edit box.
Search Content
Search Weblinks
Search Contacts
Search Categories
Search Sections
These Mambots allows searches among these items, if they are published (default).