Joomla Modules

Joomla! ExtensionsVarious Extensions explained

This document will explain how to acquire, install and configure several Joomla! Extensions that work with Joomla! 1.5.

Dwayne Trouille10/15/2008

2

Various Joomla! Extension setup notes There are many Joomla! Extensions available, some for free and some as a purchase. To search through the available extensions go to http://extensions.joomla.org/. Most of the extensions have been tested and reviewed by Joomla! users and by reading their reviews you can usually determine if the extension if worth the effort. One thing about the available extensions is that most of the sites you download them from will want you to register on their site first. I’ve registered when required and at times it has proven helpful when I needed to ask the extension developer questions.

The Joomla! Extensions I will elaborate on and provide some insight and setup help on are: Media Wiki, jfchat, iWebCal, Seyret Video Component, Phoca Gallery with Slideshow, integraded Zimbra Authentication, Fireboard Forum, Docman, Easy Captcha, Podcasting Suite 1.5, ArtForms, JooMoo for Moodle unified log in and how to install Moodle for this Extension to work correctly.

Some of the Joomla! Extensions in this document were designed for Joomla! 1.0.x but will work with Joomla! 1.5.x if Legacy mode has been enabled. To enable Legacy Mode:

1. Go to the Back-end and login as Admin.2. Go to Extensions > Manage Plugins3. Locate System-Plugen and click the red circle with an “X” to enable. Notice once

enabled the Red Circle is replaced with a Green Circle.

Joomla! Extensions are zipped files with the extension of .zip. Do not unzip the files since Joomla! will unzip and place the files in their correct directories for you when uploaded through the Back-end.

JoomlaWiki 1.5 (MamboWiki)First released in 2005 and with over 30,000 downloads, this is a component to integrate MediaWiki so your Mambo or Joomla site can offer the comprehensive wiki functionality of MediaWiki. Users can edit and create Wiki pages while administrators can manage MediaWiki and create menus to present selected pages.

The JoomlaWiki can be found on the Joomla! Extensions page http://extensions.joomla.org/ in the Clients and Groupware category the item called Wiki. Once in the list you will find MamboWiki as one of the top rated items. The Joomla! version supported to run the JoomlaWiki will be displayed in green and red. Next, a list of the various extension types included in this package are listed and you should see Component, Module, plugin and Language extensions as extensions within this install. Notice the example screenshot below.

Create your own Web 2.0 Presence with Joomla Author: Dwayne Trouille Date: October 23, 2008 ETC - Valdosta Ga.

http://extensions.joomla.org/


3

Install/Upload fix for Redhat/CentOSIf using Redhat or CentOS you may experience problems when uploading and installing your JoomlaWiki Extension. To eliminate this problem here is my fix that was actually included in the setup and configuration of the CentOS operating system and may already be applied:

1. Go to /etc/php.ini and open2. Change the line max_execution_time = 30 to 300 (This increases script execute time in sec.)3. Change the line max_input_time = 60 to 120 (This increases parsing request time)4. Change the line memory_limit = 16M to 60M (Maximum amount of Memory a script may

use. The JoomlaWiki component requires at least 50M)5. Change the line post_max_size = 8M to 20M (Max size of post data)6. Change the line upload_max_filesize = 2M to 20M (Max size of uploaded files)7. Once changes are make select Save.8. Restart your Web Service to force php.ini reload.

For a direct link to the download page go to http://www.joomlawiki.org/ and scroll down until you see the JoomlaWiki for Joomla 1.5 download as shown below:

Once downloaded do the following:1. Go to and log in to your Joomla! Back end.2. Go to Extensions > Install/Uninistall.3. In the Upload Package File field browse to and select your JoomlaWiki install file.4. Click the Upload file and install button to start the installation.5. The install may be slightly slow so patience is required. Upon successful installation you will

see the following:


http://www.joomlawiki.org/

4

6. While still in the install/uninstall select Components and notice that Joomlawiki is installed but is not a Native Joomla! 1.5 component and must be running in Legacy Mode to operate. Looking at the top of the page look for Legacy : 1.0, you can determine if the System -Legacy Plug-in is enabled and if not it must be enabled for this component to work.

7. On server open a terminal console and navigate to /var/www/html/components, then run the following command chown –R apache com_joomlawiki. The reason is that when running the CentOS and possibly any version of Redhat you will need to make apache the owner of the com_joomlawiki directory and subdirectories. If not you will get the error listed on step 9 below, but I found using the chown command above works better than the chmod command listed on step 9.

8. Go to Components and notice JoomlaWiki is listed.

9. Select Setup from the drop-down list and if installed on a CentOS Server like mine and you skipped step 7 above you may get the following message regarding the config subdirectory needing to be made writeable. If all looks well continue to step 10.


5

10. Go to Components > JoomlaWiki > Setup and the setup process should start.11. Upon successful completion of the install you will hopefully see a results page similar to that

shown below. Notice the Cache and Accelerator do not show as installed. Not sure why at this time.

12. Delete the components/com_joomlawiki/config folder for security reasons by going to /var/www/html/components/com_joomlawiki/ and delete the Config folder.

13. By default a Menu item called Wiki Options and a Module also called Wiki Option are created during the installation. This is to create the JoomlaWiki structure.

14. Go to Menu > Main Menu > New > choose JoomlaWiki from the list of items and you will the taken to the following JoomlaWiki Menu item edit page.


6

15. Enter a Title for your Wiki Menu item such as JoomlaWiki, an alias and notice it is currently set to be placed in the Main Menu but you could really place it in any menu.

16. Ensure the JoomlaWiki item is published and accessible to the public for now and in Parameters you may change the heading if so desired, choose the Show Page and allow anonymous for now so that you can access the wiki from the frontpage without being a registered user.Note: You will probably not want to allow anonymous access and may even wish to only allow registered users access to the Wiki. By adding the JoomlaWiki to the Users Menu instead of the Main Menu, they would have to log in before actually seeing the Joomla Wiki link.

17. Click Save.18. Go to your Joomla! Site frontend and verify the JoomlaWiki link is present in the Main Menu

list. Sometimes a refresh of the web browser is required for the changes to display.19. Select your JoomlaWiki and verify you have access as an anonymous user and can edit the

content by adding content to the Wiki.20. Done.

iWebCal This component takes an .ics file from iCal or any other application generating vCalendar files and displays them on your website. As mentioned this component will only display your calendar as read-only, all editing or updates to your calendar still need to be done through it’s own application. This would be good for sharing a calendar of events with visitors that simply need to see what is happening on specific dates at a glance. I have successfully linked to a Google Calendar and a Zimbra Collaboration Server calendar using this component.

1. Go to http://extensions.joomla.org/ > Calendars & Events > Calendars > iWebCal for Joomla!.2. Notice below the Download button you find a statement that says. “1.5 version of the

component can be downloaded here: http://www.jlleblanc.com/com_iwebcal15.zip”. This is the link to the version for Joomla!1.5. Note: Choosing the regular Download button will link you to the Joomla! 1.0 version which will not work in Joomla! 1.5.


http://www.jlleblanc.com/com_iwebcal15.zip


7

3. Save the installation file to your local computer.4. Go to your Joomla! Administrator page (Back-end) > Extensions > Install/Uninstall.5. In the Upload Package area select Browse to locate your install file, then choose Upload file

and Install to start the installation.6. Once you receive the “Install Component Success” display, stay in the Extension Manager page

and select Components to determine if the component is Joomla! 1.5 Native.7. Select > Components > iWebCal > New Calendar.

8. Notice you may enter a name, choose the Frontpage menu that links to iWebCal, set it to published or not, upload an exported iCal file or enter the URL to a publicly accessible ical user account on any server running an ical vCalendar solution.

9. To test this functionality using a Google Calendar, go to Google and login using your Google or Gmail account, then select Calendar.

10. Once in Google Calendar locate and select settings under My Calendars as seen below.


8

11. To export a calendar you wish to later import into the Joomla! iWebCal component select the option beside your account name called Export My Calendars as shown below.

12. To setup Google Calendar so that you may link iWebCal to your Calendar for real time updates. Choose the Shared: Edit settings and check the “Make this Calendar Public box” as shown below.

13. Select Calendar Details and scroll down to the Calendar Address row then select the green ICAL button as shown below. Note: Read the statement below the ICAL link that says No one can use this link unless you have made your calendar public.


9

14. When you click the ICAL button you will be given a link URL that will need to be copied and later pasted into iWebCal similar to the one displayed below.

15. Return to the Joomla! Administrator page (Back-end) > Components > iWebCal > New Calendar, and paste your Google Calendar Public link into the URL path at the bottom or if you elected to export the ical file, use the browse button to choose your file for upload into iWebCal.

16. Once all your information has been entered select the Upload button at the top right.17. You should receive a Calendar Link Created Notification.18. Select the Menu you want to add the Calendar link to and Save.19. Go to your Joomla! Frontend and refresh the browser if necessary then look in the Menu list

you place the iWebCal Google Calendar and notice you now have a new link. Selecting the link should open the Google calendar as embedded into your Joomla! site.

20. Below is an example of how my Google Calendar appears in Joomla! Notice, the name at the top of the Calendar is provided by the Google Account name and the Main Menu Link I assigned in iWebCal is Dwaynes Google Calendar. You should see on Oct. 28 I have on the Calendar to prepare for GAETC presentation.


10

21. Further editing of your iWebCal link is done from the Menu item pointing to your calendar. You will use the iWebCal component strictly for adding new calendars.

22. Done.

Fireboard ForumFireboard forum is just that, a feature rich forum builder that will provide a very nice forum layout on the Joomla! frontend.

1. Go to http://bestofjoomla.com.2. Select download3. Beneath the Package Name Column choose Fireboard 1.0.4. Choose the latest version. For my install I downloaded 1.0.5RC2, the latest at the time.5. Make sure you choose the filename that ends with .zip6. Go to your Joomla! Administrator Page (Back-end) > Extensions > Install/Uninistall.7. Use the Upload Package File Browse Button to locate your file, then choose Upload File &

Install to initiate the installation process.8. Once the installation is complete you should receive an Install Components Success like below.


http://bestofjoomla.com/

11

9. While still in the Extension Manager, select components and notice Fireboard is not a native Joomla!1.5 component which requires the System – Legacy Plugin be enabled.

10. Go to Components > Fireboard Forum > notice the Fireboard Forum Control Panel is opened.11. Select Fireboard Configuration and read through all the available options. While any or all of

these settings can be modified the Configuration should be left at its default settings for now.12. Go to Forum Administration, select “New” then choose a Parent unless this is the first Category

for the forum. Provide the Name, Description and Header for your new forum.

13. Once the first Category is created with “No Parent” chosen, select “New” again to repeat the same process with the exception you will use the previously created category as the Parent as shown below:


12

14. The FireBoard Administration will now list your new categories. Make sure to click the red X under Published so the forums are available.

15. Go to Menus > Main Menu* > New , and choose FireBoard Forum in the Menu Item Type list.

16. Fill in the Title, Alias and Page Title information then select Save.

17. Go to your Joomla! Site Frontpage and select the new menu link that points to the Fireboard Forum.

18. By selecting the Categories Tab you will find the Forums created in the Back-end earlier.


13

Seyret Video ComponentSeyret is a Joomla! component that provides an embedded video player/library. With Seyret you can link to videos on sites like YouTube and also upload videos directly to your server for local playback. Some of the video formats supported are wmv, mpg, mp3 and swf files. As you test Seyret you will find many more options not mentioned in this quickstart process.

Important: Seyret Video Component requires Fireboard Forum to correctly built the video frontend video viewing area. If you have not already, go back to the Fireboard Forum install and at a minimum run the installation before proceeding with the Seyret Video install.

If you want to allow larger file uploads you may have to adjust the following settings in php.ini.file_uploads = Onpost_max_size = 60Mupload_max_filesize = 60Mmax_execution_time = 300

1. Go to http://extensions.joomla.org/ > Images & Multimedia > Video Gallery > Seyret Video Component.

2. Select the Download button and you are taken to the developer website Joomlaholic.3. Download the latest version which at the time of this writing was 0.2.8.1.4. Go to your Administrator page (Back-end) > Extensions > Install/Uninistall, choose the Upload

Package File browse button to locate and select the installation file.5. Select Upload File & Install to initiate the install process.6. Once the install is complete you hope to receive a notice of “Install Component Success”.7. While still in the Install/Uninstall page of Extensions, select the Component item and notice

Seyret is not a native Joomla! 1.5 component and relies on the plugin “System-Legacy”.

8. Go to Components > Seyret

9. Once the Seyret Component is open notice you have to install the Seyret Database components and accept the terms of use.



14

10. On some installations you could be asked to install Flash.11. Notice the Seyret Component will display a Seyret menu to the left. Choose Diagnostics from

the menu list and if using a CentOS server observe your session username is apache but the owner is set to root. This will need to be fixed using the following command from /var/www. chown –R apache html

12. Upon running the chown command above refresh your page to verify the Diagnostics displays the following:

13. Now go to the Permissions and notice you have Public Frontend and nothing more. Select Create your own Web 2.0 Presence with Joomla Author: Dwayne Trouille Date: October 23, 2008 ETC - Valdosta Ga.

15

Public Frontend and view all the permissions assigned. Notice some permissions such as upload video is set to NO which is good since you don’t want anyone to upload videos to your site.

14. While in Syret Permissions create a new Syret Access Rights group by selecting “New” then use the Joomla! Access Level pulldown to select “Registered” for registered users. Notice all permissions are set to NO by default, but you may change any or all of them. Registered users will supply a username and password to authenticate, at which time they can access the Syret Video Component with unique permissions you assign here.

15. Assign the Registered Users the following permissions so allow uploads and editing:

16. Assign the Public Frontend the following permissions that allow viewing and downloads:

17. While in the Seyret Menu select Categories > New to create a new category. Categories can be

listed as tabs in Syret for video grouping and management. An example of a Category could be Math Videos.

18. Select Save.19. Create a Menu item for frontend access by going to Menus > Main Menu > New > seyret as

displayed below.


16

20. In the Seyret item type details provide a Title, Alias and Save.

21. Go to your Joomla Site Frontend then locate and select the new menu item created for Syret videos.

22. Since you are not a registered user all you can do is view videos but so far none exist.23. Go back to the Home location of your Joomla! frontend and login as any registered user. 24. Select the Syret Video Link and notice as a registered user you can see all tabs including the

Upload Videos.25. To add a Video Link go to a site such as Youtube and find an appropriate video to watch. Once

the video starts to place copy the URL from your browser.26. Go back to your Syret Video Component and ensure you are logged in as a registered user that

has the permissions to add video.27. Select the “Add Videos” tab then paste the copied YouTube URL into the “Input Link” field.28. Click the Apply Button.29. The next screen provides the details pertaining to your new video link. All fields can be edited

but for now focus on the Category option and choose an appropriate category for you video, if that is that you created a category earlier.

30. Once finished editing the details for this video click Save.Create your own Web 2.0 Presence with Joomla Author: Dwayne Trouille Date: October 23, 2008 ETC - Valdosta Ga.

17

31. The video should now be viewable by public frontend and editable by registered users.

DOCmanDOCman is a document management and download system for Joomla!. With this component your users can easily upload and manage files across multiple categories and make them available for download on your Joomla! website.

1. Go to http://extensions.joomla.org/ > Directory & Documentation > Downloads > DOCman > Downloads.

2. Under Package Name scroll down and select 1.DOCman.3. Find Release Name 1.4.0RC3 then choose the filename com_docman_1.4.0rc3.zip.4. Once downloaded go to your Joomla! Administrator page (Back-end) > Extensions >

Install/Uninstall.5. Using the “Upload Package File” browse to your install file and select, then choose “Upload

File and Install”.6. Once the install is finished go to Components > DOCman > Configuration.

7. When the Configuration opens look at the status of the docman.config.php file and make sure it is set to writable. If you are running Joomla! on CentOS you may experience an issue where this file is not writable. If that occurs open a Terminal Console, go to /var/www/html/administrator/components and execute the following command:

chown –R apache com_docman

8. Upon executing the above command, return to your Joomla! Backend and refresh the DOCman Configuration screen to verify the docman.config.php file is now writable.

While the DOCman Configuration options are self explanatory we’ll quickly step through them.

9. Select the Configuration General Tab and place your pointer over the blue exclamation point, then notice a balloon help appears explaining how to change the path where your DOCman will



18

place files.

10. The Configuration Front-end allows you to change the look and feel of DOCman.

11. The Configuration Permissions determines what Guests and Registered users may do in DOCman

12. The Configuration Upload allows you to choose one or more upload methods, set the Max upload file size, whether or not files may be over-wrote and what file types may be uploaded among others. Set the “Max . filesize allowed when uploading” to 20M for larger files.


19

13. The Configuration Security allows you to prevent the capability of linking to documents in DOCman and can prevent the viewing of remote links within the document details.

14. Add a new DOCman Category, by selecting Components > DOCman > Categories > Add.15. In the Details provide a Category Title and Category Name. These can be the same.

16. Save your new category.

17. Notice the group just created is called Dwaynes Files, is published, accessible to the public and has a Category ID of 43 (your Category ID should be different). The Category ID will be used again when creating the Menu item.


20

18. Choose Groups then Add from the toolbar to add a new group.

19. Enter a Group Name and Description, then move users from the “Users Available” box to the “Members in this Group” box by selecting the user and clicking the arrow button in the direction of the box you want the user moved into.

20. Create a menu item for DOCman files in the Main Menu by selecting Menus > Main Menu * > New > DOCman as Menu Item Type.

21. In the DOCman Menu item edit screen supply a Title, Alias, ensure Published is checked and set a Default Category ID if you want the DOCman page to open to a specific category, but leave blank if you wish to see all upload directories.


21

22. Go to your Joomla! Site Frontend and if you do not see the new Menu item linking to DOCman do a refresh of your browser to force a site reload.

23. Click the link that points to your DOCman files in my example if would be a link named files. Notice the Main Menu item called Files links to Dwayne’s Files.

To download files the Download, View and Details buttons will have to be present. There is an issue that sometimes occurs during DOCman installation that prevents the files that provide the Download, View and Details buttons not to install. Should you get to this point and find these buttons are missing do the following:

Manually extract the contents of the DOCman install file com_docman_1.4.0rc3.zip Go to the unzipped folders and open the plugins Folder. Copy both the files inside plugins “standardbuttons.php and standardbuttons.xml.php” to

/var/www/html/plugins/docman Once the files have been copied over go back to your Joomla! Site Frontpage and go to

the DOCman location again and verify the buttons are present.24. To upload files you will need to login as a Registered User then go to the DOCman page.

Phoca Gallery with SlideshowCreate your own Web 2.0 Presence with Joomla Author: Dwayne Trouille Date: October 23, 2008 ETC - Valdosta Ga.

22

Phoca Gallery is an Image Sharing Component that allows users to upload images that are then shared using a Slideshow utility build with Flash.

1. To download go to http://extensions.joomla.org/ > Imaged & Multimedia > Photo Gallery > Phoca Gallery with Slideshow > Download > Phoca Gallery 2.0.2 > com_phocagallery_v2.0.2.zip.

2. Now that you have the install file go to your Joomla! server Back-end > Extensions > Install/Uninstall > Browse to the Phoca package file > Upload and Install.

3. Once the Joomla! Upload is complete you will be prompted to Install or Upgrade depending on whether you already have an earlier version of Phoca installed or not. Choose Install.

4. Before using the Phoca Gallery Control Panel go to Site > Media Manager > phocagallery.5. In Media Manager locate Files Path field then notice to the right is a “/” and an empty field used

to enter a new folder name. Enter any name of your choice, for example I will use Dwayne then click “Create Folder”. This should create a new folder in the phocagallery directory.

6. While still in the Media Manager, select your newly created folder and you will notice a “Browse files” button at the bottom. Select “Browse files” to locate, then click “Start upload” to place an image the new folder. This is not required, it’s just nice to already have an image in the folder before viewing from the Joomla! frontend.

Notice the screenshot below shows a new image just uploaded into a folder named Dwayne Create your own Web 2.0 Presence with Joomla Author: Dwayne Trouille Date: October 23, 2008 ETC - Valdosta Ga.


23

which is a sub-folder of the PhocaGallery directory.

7. Go to Components > Phoca Gallery > Categories.8. Select “New” to create a new category. The first Category will simply be used as a place holder

or parent category to hold other related categories.

9. Provide a Title, for example I will use “Staff” since I will eventually make all staff members categories a child category to Staff. Similar to grouping. Notice in the screenshot that Public is allows Access, but only Registered users can Upload and Delete.

10. Select “New” again, this time using the name of the folder created in Media Manager earlier,


24

which in my case is a folder named Dwayne, and also selecting a User Folder by clicking the Folder button and selecting the folder created for Dwayne in Media Manager from the list. Note: To select the folder from Media Manager you have to click the arrow pointing down as shown here:

Notice for Dwayne I selected the Parent Category of Staff, allowed Public Access, allowed both Administrator and Dwayne access to user rights, and only Dwayne can upload or delete.

11. Select Save to create the new category.12. While still in the Phoca Gallery Control Panel select Images.13. Select “New” for a new image.14. Provide an image Title, Alias, ensure published is checked.15. Choose the category of this image for example my category is Dwayne.16. Provide a filename by clicking the image button then browse to the same category folder and

choose the image uploaded when in Media Manager. Again my example Category is Dwayne.

17. Select Save to finish.18. Repeat adding the image process for each category you create in Phoca Gallery. Note: It

doesn’t seem to work correctly unless you perform the image insert step for each category.


25

19. Go to Menus > Main Menu* > New > Choose one of the available Phoca Gallery menu types.

You should experiment with each Menu item type to determine your preference.

20. When the Menu item edit screen appears, supply a Title, Alias, and Select Category (Parent Category). Note: My example is using a title of Staff Images that opens the Parent Category of Staff. There are many options not discussed that you should test to fully understand all the capabilities but this example should get you started.

21. While in the Menu Item Type edit page expand Parameters (Component) and scroll down until you see a category labeled Upload Settings and notice you can modify the Frontend Max file Upload size as well as the allowed Disk Space as shown below. Will help with larger files.

3,000,000 = 3MB and 20,000,000 = 20MB22. Select Save. 23. Go to your Joomla! frontend and observe the new menu item in your Main Menu. Select the


26

link and test your new Phoca Gallery component.

Podcasting Suite 1.5

1. To download go to http://extensions.joomla.org/ > Images & Multimedia > Podcasting > Podcast Suite > Download.

2. Locate Podcast Suite 1.5 Beta and download the Component, Module and Plugin.3. Go to the Joomla! Back-end > Extensions > Install/Uninstall > Browse to the podcast suite

package file then choose Upload File & Install for the Component, Module and Plugin.4. Go to Extensions > Plugin Manager > Content – Podcast and Click the red x to enable. The

plugin that turns {enclose ...} tags into players and links.5. Go to Extensions > Module Manager > Podcast and click the red x to enable. Provides links for

users to subscribe to your podcast feeds.6. Go to Components > Podcast Suite (Podcast Files Manager) > Parameters (Global

Configuration).

The Path for Uploaded Media can me modified but the default path should work fine. Choose how to link to the podcast enclosures; Quicktime wil play audio or video. Player Width and Height should be tested. I would start with 320x240 and work up. Go ahead and enter support for multiple MimeTypes. Here is a list of possible mimetypes

and how to enter them in the field: audio/mpeg, video/quicktime, audio/x-m4a, video/x-m4v, audio/mp4a-latm, video/mp4, video/mpeg, audio/x-wav

Save changes

7. Go to Content > Section Manager > New and create a section named Podcasts, then Save. Note: You may name the section anything you like, I’m using podcasts as my example.

8. Go to Content > Category Manager > New and create a category named instructional and set it to use the Podcasts Section created earlier. Repeat the process by creating a second category named technical. Note: You may choose any name for your categories; these are just for use as an example.

9. Use any FTP client to connect to your Joomla! site and upload your podcast media files to the /var/www/html/components/com_podcast/media. Core_FTPlite is a good FTP client choice.

10. On the Joomla! Back-end go to Components > Podcast Suite (Podcast Files Manager) and select your new podcast media file.

11. Assign your new media file a “Title” then simply click the “Save and Publish this Article” button.

12. When the Article Edit page is displayed make sure to assign your Section and Category created earlier for podcast articles.

13. Go to Menus > Main Menu > New > choose Articles > Section > Section Layout when in the



27

Menu Item Type page. Note: You may choose any Menu available, the Main Menu made the example easier. Section Layout will allow you to list all Categories on a single Section page.

14. In the Menu Item Edit page provide a Title, choose your podcast section created earlier and make sure you do not have “Empty Categories in Section” under parameters set to Show.

15. Select Save.16. Go to your Joomla! Site Frontend, find your podcast menu item in the main menu and test.

EasyCaptchaEasyCaptcha provides an easy-to-use captcha engine. All captchas are written as plugins so that EasyCaptcha can be easily extended by installing a new captcha using the integrated installer.

1. Go to http://extensions.joomla.org/ > Access & Security > Captcha > EasyCaptcha > Download, then choose Version2.0beta1 filename com_EasyCaptcha_2.0_beta1.zip.

2. Go to the Joomla! Back-end > Extensions > Install/Uninstall > Browse to the EasyCaptcha package file then choose Upload File & Install.

3. Go to Components > EasyCaptcha > Manage Captchas, and make sure the Dpaulus-Captcha is enabled or published.

4. The EasyCaptcha will be demonstrated as a security feature for ArtForms.



28

ArtForms1. Go to http://extensions.joomla.org/ > Communications > Forms > ArtForms > Download > in

the Package Name column find ArtForms-Component-J1.5.x and then select ArtForms2.1b7.1-for-J1.5-RC1.zip.

2. Go to the Joomla! Back-end > Extensions > Install/Uninstall > Browse to the ArtForm package file then choose Upload File & Install.

3. Once install is complete go to Components > ArtForms > Settings and check status of the config.artforms.php. If it is displaying “Unwriteable”, run the following command from /var/www if running a CentOS Server: chown –R apache html

4. After running the chown command, check the config.artforms.php status again and verify it’s now writeable. Also check the CSS and Language files by selecting the respective tabs.

To Create a form1. Go to Components > ArtForms > Forms > New 2. Provide a Form Title, Target email address of recipients, check the Publish box then scroll down

to the “Activate Verification Code?” and choose EasyCaptcha Component from the pull-down list.

3. Select the “Text” tab and provide both an Introduction and Confirmation text.4. The “Files” tab allows you to setup the ability to attach specific filetypes. Choose “Allow File

upload and email Attachment” .5. In the “Allowed Filesize” field enter 5000. This equals 5MB.6. Set “Limit Attachments to:” 1.7. For “Files attachments will be mandatory” select NO.8. Under File Types Allowed check the box for .txt found under Miscellaneous.9. Save your current settings. Note: The remainder of the form cannot be constructed until you

have saved the settings for the Settings, Text and Files tabs.10. Select your form from the forms list.



29

11. Select the Menu tab and in the “Select a Menu” list pick a menu that will link to your form. For testing purposes use the mainmenu (Main Menu).

12. Select a Menu Type, either should work fine.13. In the “Menu item name” provide a name that relates to your form purpose.14. Check the Publish box.15. Click the Make Menu button and a Menu is generated in the Menus > Main Menu list.16. Select the Fields tab.17. Use the New Field list to choose the number of fields required for your form.18. If all fields are not viewable click the icon of an eye without the X found at the top. Likewise,

click the eye with the red X on top to not see all fields.19. In each Field choose what type of date you want to collect using the appropriate boxes.20. The following is an example you may use for building a quick form:

Choose to build a 4 text field form Click the eye without the X to show all fields In Field 1

In Field 2

In Field 3

In Field 4

Click Save.

21. Done


30

Zimbra Plugin and Modules for Joomla

These directions have been tested with Joomla 1.5 and Zimbra Open-Source 5.0.8, both running on CentOS 5.2

Document Created 8-13-08

Zimbra Server Information ModuleJoomla PHP Module that uses Ron Gage's zimbraAdmin SOAP PHP Class to get Version, Services status and Mail Queues Information from a Zimbra Server. Because the communication between the Joomla module and Zimbra is via Zimbra's SOAP API, the Joomla and Zimbra Servers do not need to run on the same machine. (Ron's code is included and installed automatically)

Installation1. Download the Module from http://www.all-our-email.com/. Note: Registration is

Required.

2. Once downloaded, connect to your Joomla Administrator page and select Extensions – Install/Uninstall.

3. In the Upload Package File box, select the browse button and navigate to the location you saved the module file on your local computer, select the file and choose open.

4. Select the “Upload File & Install”.

5. If all goes well, you will receive an indication that the install was successful.

Configuration1. Go to Extensions – Module Manager.

2. Locate and select Our Zimbra Info module from the list.

3. Set a Title Name of your choice.

4. Select Yes for both Show Title and Enabled.

5. Set your preferred Position, Order and Access Level.

6. For Zimbra Server Name/Address enter the hostname of your Zimbra server followed by the domain name or use the IP Address of your server without the http://. Example: zimbra.do-main.com.

7. For Zimbra Admin Account enter an account name that has administrative rights to your Zimbra email server. Example: [email protected]. Note: See page 3 about secondary Zim-bra admin accounts.

8. For Zimbra Admin Password enter the password assigned to the admin account listed in the pre-vious step. Note: The password is not hidden from view by asterisks.


mailto:[email protected]

http://www.all-our-email.com/

31

9. In the Connection Failed Message you may leave the default message or create a custom mes-sage.

10. The remaining choices of Zimbra Version information, Zimbra Services Status, Colour Code Status and Zimbra Mail Queues Information will be displayed if you select YES, or if you choose NO, it will not be displayed. Set these to your own preference. The header information likewise , is an option for you to provide your own header text or leave the default in place.

11. Apply or Save your changes, and if you chose “enabled” in step 4 you can now Preview your changes on the Joomla frontend. If you chose Public access the Zimbra Information should be immediately available, but if you chose Registered Access you will need to logon first.

Pre-Installation steps on Zimbra Server for both the Zimbra Mailbox and Logon Modules

On Zimbra server enable PreAuth and acquire a key

1. Using whatever method you have available, start a Comman Line Interface (CLI) or in other words start a terminal session either locally or through an ssh connection.

2. Navigate to /opt/zimbra/bin

3. Become the Zimbra User by using the Substitute User command syntax su – zimbra then press return.

4. Run the ZMPROV command by using the command syntax zmprov then press return. This takes you to the prov>

5. Enter the following syntax: gdpak your_domain_name and press return. The following is an example of what you might see:prov> gdpak domain.com preAuthKey: 4e2816f16c44fab20ecdee39fb850c3b0bb54d03f1d8e073aaea376a4f407f0c prov>

Find more details about the PreAuthKey at http://wiki.zimbra.com/index.php?title=Preauth

6. Once your preAuthKey: is displayed, copy the entire string of alphanumerics and past into a text document that can be referenced later in the Joomla/Zimbra modules parameters settings. Ensure you get the entire string.

Setting Zimbra email Web Server Mode to http or https accessThe Zimbra email Web Console can be accessed using http or https. By default it is set to use http but can easily be modified in the CLI. Here are some quick instructions.

1. Using whatever method you have available, start a Command Line Interface (CLI) or in other words start a terminal session either locally or through an ssh connection to your Zimbra Server.


32

2. Navigate to /opt/zimbra/bin and become the zimbra user with command su – zimbra

3. Using the syntax: zmtlsctl http will cause email web access to use the http protocol, and using zmtlsctl https will cause the email web access to use https access. To learn more, type man zmtlsctl or zmtlsct –help, or go to http://wiki.zimbra.com/index.php?title=CLI_zmtlsctl_to_set_Web_Server_Mode

4. Once your settings have been changed, you need to restart the Zimbra Server. To do this use zmcontrol stop, then once fully stopped use zmcontrol start.

Note: The Zimbra Mailbox and Zimbra Logon modules only list http or https, so using any other mode may not be recommended. Document your settings for use later when configuring the Zimbra Modules in Joomla.

Create a secondary Zimbra Administrator Account (Optional)A Zimbra Administrator account will be required if you decide to use the Zimbra Account Creation Plug-in and the Zimbra Server Information Module. If you prefer to limit the use of your default Zimbra Admin account then you may want to create a secondary admin account for us in Joomla. Again, this is totally optional; just know that anyone with access to your Joomla Modules will see your password since it is not hidden from view.

1. Log into your Zimbra Administration Web Console using your admin account. Remember your Admin Page is typically located at https://zimbra.domain.com:7071/zimbraAdmin.

2. Find and select Accounts, then choose New Account.

3. While filling in the General Information for this account use a name that can be easily remem-bered and understood to be used for your Joomla setup, also make sure to check the Administra-tor box in the Account Setup category to give the account Administrative privileges.

The importance of TimeIf your Zimbra and Joomla servers are not running on the same physical server, it is vital they have the exact same time for the Zimbra Mailbox and Zimbra Logon modules to work. Ensure you have both servers setup to the correct date, time and on the correct Timezone. In addition, I recommend using a NTP (Network Time Protocol) Server and disable the use of Local Time Source. By ensuring both servers are receiving their time from a NTP Server you should eliminate unnecessary problems.

Zimbra Mailbox Info ModuleJoomla PHP Module that shows the current number of messages in your Zimbra InBox and optionally, other message folders. The module can also be configured to link to the actual Zimbra mailbox URL allowing you to jump straight to the InBox. It uses the current logged on Joomla account as the account name for Zimbra and optionally shows a message to highlight the fact that you have new e-mail. (For Joomla 1.5). Note: The Zimbra Mailbox Module and Zimbra Logon Module both share the same Pre-Installation Create your own Web 2.0 Presence with Joomla Author: Dwayne Trouille Date: October 23, 2008 ETC - Valdosta Ga.

https://zimbra.domain.com:7071/zimbraAdmin

http://wiki.zimbra.com/index.php?title=CLI_zmtlsctl_to_set_Web_Server_Mode

http://wiki.zimbra.com/index.php?title=CLI_zmtlsctl_to_set_Web_Server_Mode

33

steps on your Zimbra server, therefore, it’s assumed that you have already completed the Zimbra pre-installation steps found on page 2 and you have documented all your information for use when configuring these Zimbra Modules.

Installation

1. Download the Module from http://www.all-our-email.com/. Note: Registration is Required.


3. In the Upload Package File field select the browse button and navigate to the location you saved the module file on your local computer, select the file and choose open.

4. Select the Upload File & Install.


Configuration1. Go to Extensions – Module Manager

2. Locate and select Our Zimbra Mailbox module from the list.


4. Select Yes for both Show Title and Enable.

5. Set your preferred Position and Order

6. Access Level must be set to Registered.

7. For the Domain Key PreAuth use the text document saved earlier then copy and paste the key into the Domain key field. Reference Pre-Installation Steps on page 2, step 6 for info on your PreAuth Key.

8. For Zimbra Server Name/Address enter the fully qualified domain name without the http://. For example: zimbra.domain.com. This is because you choose to use either http or https next.

9. For HTTP or HTTPS you select the radio button that reflects the settings you chose earlier un-der “Setting Zimbra email Web Server Mode to http or https access”

10. For the Logon Prompt Message, Connect Failed Messager, New Email Message, Show All Mail Folders, Link From Inbox, and Use New Window Fields you may leave all set to their default settings or adjust to your preference.



34

11. In the Redirect URL field, enter the full URL to your Zimbra Web login for email users ensur-ing that you set http or https correctly depending on your settings in step 8. Example http://zimbra.domain.com

12. Apply and/or Save your changes, then logon to your Joomla Frontend and look for your Zimbra mailbox.

Zimbra Logon ModuleJoomla PHP Module that uses a Zimbra PreAuth URL to pass the current Joomla logged on user as a Zimbra Logon bypassing the need to dual logon. (For Joomla 1.5). Note: The Zimbra Logon Module and Zimbra Mailbox Module both share the same Pre-Installation steps on your Zimbra server, therefore, it’s assumed that you have already completed the Zimbra pre-installation steps found on page 2 and documented all your information for use when configuring these Zimbra Module.

Installation 1. Download the Module from http://www.all-our-email.com/. Note: Registration is

Required.


3. In the Upload Package File field select the browse button and navigate to the location you saved the module file on your local computer, select the file and choose open.



Configuration

1. Go to Extensions – Module Manager

2. Locate and select Our Zimbra Logon module from the list.


4. Select Yes for both Show Title and Enable.

5. Set your preferred Position, and Order.

6. Access Level must be set to Registered.

7. For the Domain Key PreAuth use the text document saved earlier to copy and paste the key into the Domain key field. Reference Pre-Installation Steps on page 2, step 6 for info on your PreAuth Key.



http://zimbra.domain.com/

35

8. For Zimbra Server Name/Address enter the fully qualified domain name without the http://. For example: zimbra.domain.com. This is because you choose to use either http or https next.

9. For HTTP or HTTPS you select the radio button that reflects the settings you chose earlier un-der “Setting Zimbra email Web Server Mode to http or https access”

10. For the Logon Prompt Message, Expires (minutes), Show Expire Time and Use New window fields, you may leave all set to their default settings or adjust to your preference.

11. In the Redirect URL field, enter the full URL to your Zimbra Web login for email users ensur-ing that you set http or https correctly depending on your settings in step 8. Example http://zimbra.domain.com

12. Apply and/or Save your changes then logon to your Joomla Frontend and test your new Zimbra Logon.

Zimbra Account Creation PluginJoomla User Plugin that will create a Zimbra account during Joomla User Registration. This new version now uses Ron Gage's zimbraAdmin SOAP PHP Class to create the Zimbra account. Because the communication between the Joomla Plug-in and Zimbra is via Zimbra's SOAP API, the Joomla and Zimbra Servers do not need to run on the same machine. Plugin has been updated to use the same password for Zimbra as for Joomla and to synchronise the enabled/disabled state of the Joomla account on to the Zimbra account. (For Joomla 1.5).

Installation1. Download the plugin from http://www.all-our-email.com/. Note: Registration is

Required.


3. In the Upload Package File field select the browse button and navigate to the location you saved the plug-in file on your local computer, select the file and choose open.



Configuration1. Go to Extensions – Plugin Manager

2. Locate and select the plug-in named User – Our Zimbra User from the list.

3. In the Name field you may assign a name or keep the default name.

4. Check the Yes radio button for Enabled.



http://zimbra.domain.com/

36

5. Set Access Level to Registered.

6. Adjust the order if you wish, it really doesn’t matter.

7. For Zimbra Server Name/Address enter the URL name without http or https. Example: zim-bra.domain.com

8. In the Zimbra Admin Account field enter a Zimbra admin account name so that the plug-in can authenticate with your Zimbra server with Administrative rights.

9. In the Zimbra Admin Password field enter your Zimbra Admin account password and under-stand the password is not hidden or filled with asterisks.

10. For the Zimbra Domain Name field enter the name of your domain, such as domain.com. If you have problems try adding the server host name such as zimbra.domain.com.

11. Apply and/or Save your changes.

12. Now, each time you create a new user account in Joomla, a message will display indicating an email account on Zimbra was enabled OK, if all is working fine.

Moodle Module by ProMoodleProMoodle has developed several Joomla! Extensions to integrate your Moodle and Joomla! experi-ence. The extensions this discussion will focus on it the Moodle Module. The Moodle Module will al-low registered Joomla! users to connect to a Moodle server using their Joomla! user credentials. Once the user has been authenticated in Joomla!, they can access Moodle courses through a link without hav-ing to authenticate again in Moodle.

The process for making this Joomla! Module will require you install Moodle on your Joomla! server in-side the Joomla! root directory. For example: If you installed Joomla! at /var/www/html then you would create a folder inside of html and name it moodle to install your moodle server. However, if your Joomla! is installed at /var/www/html/joomla, you will have to create your moodle directory in-side the Joomla folder. That is why during the CentOS install process I recommend installing Joomla! to html instead of creating a subdirectory named Joomla!, because it makes the path to your Moodle server longer.

-Install Moodle

Moodle is an Open-Source online course solution. Managing the course content will require a data-base be created in MySQL just like that done for the Joomla! server.

1. Create a database for your Moodle server using phpmyadmin just as when creating the Joomla! database.


37

Use a web browser and navigate to http://your_joomla_site/phpmyadmin

Enter a database name in the Create new database field and click Create.

Once the new database is created you should see the following:

Select the Privileges tab to add a new user and if you don’t see that option you may need to click on the “Open New PhpMyAdmin Window”.

Select “Add a new User”.


http://your_joomla_site/phpmyadmin

38

Supply a username, password and choose “Check All” for Global Privileges. Then se-lect the “Go” button found at the bottom right of page.

Go back and verify your database privileges list the new user with All Privileges.

Done. Just document your database, username and password for use later.

May need to create the jadmin user and give privileges to Joomla! DB at this point so Moodle can authenticate to Joomla! DB correctly!!!

2. From your Joomla! Server Desktop use the Firefox browser to download Moodle from http://download.moodle.org/ by choosing the latest stable version.

3. Once downloaded simply double-click and the File-Roller application will launch allowing you to choose the location to extract your moodle files. Choose the location of your Joomla! server root and once extracted you will find a folder named moodle inside your Joomla! web root. The web root for Joomla depends on where you extracted the Joomla! files. During the install process I recommended /var/www/html, therefore you should now have a moodle folder inside the html folder. How to extract packages in the CentOS Desktops was explained in the Joomla! install and configuration instructions.

4. Using a terminal console, go to /var/www/html and run the command: chown –R apache moo-dle


http://download.moodle.org/

39

5. To install Moodle, use a web browser and go to http://your_joomla_address/moodle. Notice an install page appears as seen below. Set the correct language and select next.

6. The next screen will check your server PHP settings. If all checks pass select next.

7. The following screen has you verify your install location and web address. If you have regis-tered an internet domain name for this server you may enter it in the Address field. Notice the Data Directory is set to /var/www/moodledata. Moodledata cannot be accessible from the web but needs to be accessible and writeable by the web user “apache”. At the server open an termi-nal console and navigate to /var/www then use the command mkdir moodledata to create the directory then use command chown –R apache moodledata to assign apache ownership. Se-lect Next and if something still isn’t correct you will be get a notice otherwise it should advance to the next screen.


http://your_joomla_address/moodle

40

8. The next screen will request information about the database and user accounts to be used so Moodle can populate the database with its tables. The example screen shows a database name moodle_db and User named moodleuser. Your naming should be different.


41

9. Various PHP extension will be checked and if any are not installed you will receive a notifica-tion. Remember, you can install any of the php extensions by going to the server and running the command yum search missing_extension_name, and once it displays the name you can run yum install extension_name. Once you install the extensions remember to restart the web service using command service httpd restart.

If all Status indicators state OK, click next.

10. When the Language pack download screen appears just click Next. You typically only want a single language which is the one you are installing. Unless necessary I don’t recommend multi-ple languages.

11. The last step of the installation is to write all changes to the config.php file. If you get an error at this step you will need to go back to step 3 and use the chown command. If all goes well you will see Configuration Completed then click Continue.


42

12. Read the GPL license then click Continue

13. At the Install Build Page you have the option to do an Unattended install. My preference is to watch the install so I can see if there are problems, so I do not check the unattend box. Click Continue.

14. The first stop in the install process will hopefully display the image seen below. If successful click Continue. As you go through the installation process the install script will stop several times and display either successful updates and/or errors. Look through the list each time the script stops and ensure everything installed successfully and if errors exist make a note so they can be resolved.


43

15. When the Setup Administrator Account page displays make sure to fill in the required fields and document your admin username and password for later reference. Once through entering infor-mation click the Update Profile button at bottom.

16. In the Front Page Settings page supply a Full and Short Site name then Save Changes.


44

17. Once you see the screenshot below your Moodle Site is installed and running. Notice you are currently logged in as the Admin user.

18. While still logged into Moodle as admin in the Site Administration page as shown above, select Users > Accounts > Add a new user.

19. Create a new user account that can be used in Joomla!. An example would be the username of jadmin as shown below.

20. While the Users Category is opened locate and select Permissions > Assign system roles to as-sign jadmin the Administrator system role. See screenshot below.


45

21. Click the Administrator System role then move the jadmin user account from the Potential User to the Existing Users role by selecting jadmin and clicking the Add button as shown below.

22. While still in the Users Category select Authentication > Manage Authentication > locate the authentication plugin named External database and click its Settings. Notice it is not enable therefore is grayed out and the eye is closed.

23. Before entering the required information for External Database, open your phpmyadmin and se-lect your Joomla! database. View the Table: jos_users to find the Field id names for username and password that are required in some of the External Database fields.


46

24. The External Database Settings should use your Joomla! Users Database for Authentication in-stead of the Moodle Users DB. Tips: Host=localhost since moodle is installed locally, DB Name = Joomla! Database name, DB User = Joomla! DB read access, Table = jos_users (Joomla! Users Table), Username & Password Fields found in Jooml! Jos_users table. Make sure the External db encoding is set to that of the Joomla! database. It’s usually utf-8.Save Changes and Enable External Database by clicking the eye.

Moodle will now use the Joomla! user database for authentication with the exception of the Moodle Administrator account. The Moodle admin will still be able to login directly to the moodle server using the moodle created password.

-Configure Joomla! for Moodle Login

1. Go to your Joomla! server Back-end > User Manager > New > create a user with the same name as the one created in Moodle that was given the Administrator System Role earlier and make this user a member of the Joomla! Administrators group.

2. Download the Moodle Component and Module form http://promoodle.com/index.php?option=com_docman&task=cat_view&gid=17&Itemid=67.

3. Go to your Joomla! server Back-end > Extensions > Install/Uninstall > then browse to the Moodle Component Package file and choose Upload File & Install. Repeat the process to in-stall the Moodle Module.

4. The Moodle Extensions will have the same issues many have when installed on a CentOS server so at this point go to the server and use the Terminal Console to run the following com-mand from the /var/www directory. chown –R apache html


http://promoodle.com/index.php?option=com_docman&task=cat_view&gid=17&Itemid=67

http://promoodle.com/index.php?option=com_docman&task=cat_view&gid=17&Itemid=67

47

5. Go to Components > Moodle > Configuration > and enter the folder name of your Moodle di-rectory. The Moodle folder name is a relative name in respect to the location it exists to that of the Joomla! folder. Since I had you create a folder named moodle inside of the Joomla! folder the relative path would be simply “moodle” without the quotations. You should also pay atten-tions to letter-case; my moodle directory did not have any upper-case letters. Observe the ex-ample below:

6. Once your Moodle path is set, click Save.

7. Go to Extensions > Module Manager > Moodle Link > Enter a Title, Enable this module, choose a frontpage position for this link, and set the Access Level desired. Then Save.

Test the Moodle Authentication

1. Create a new user account in the Joomla! Back-end User Manager. Make sure the user ac-count is a member of the Registered group and has a real and unique email address. There is nothing special about creating the user, observe the example below.


48

2. The user will receive an email from your Joomla! site with the notification they have been added as a user to your site with a link to your site including their username and passwork.

3. To access Moodle the user must first go to the Joomla! Frontend and login with the user-name and password they received via email.

4. Once logged into the Joomla! Frontend the user can click on the Moodle Link – Courses button.

5. The first time a user is linked to Moodle from Joomla! they are required to update their pro-file. They must fill in all items in red then choose Update Profile at bottom.


49

Once updated the users need to completely log out of Moodle and Joomla! then go back to the Joomla Frontend and login again. When they click the Moodle Link this time they are send straight into their Moodle course.

From this point on the users only have to authenticate through the Joomla! frontend and click the Moodle link. Note: Users will not be allowed to login directly from the Moodle login screen because they are authenticated against the Joomla! database and must use the Joomla! frontend.

If you are the Moodle Administrator you should see no difference in the management and func-tionality of Moodle with the exception of users created in Joomla! will have to be authenticated by the Joomla! frontend and users created in Moodle can login from the Moodle login screen.

6.


Documents

Joomla Modules