Beruflich Dokumente
Kultur Dokumente
listing automobiles, or selling homes. The following manual will give you a clear understanding of how to install Joomanager and also how to setup this software and get your site up and running. Copyright 2011 Joomanager.com Revision History --------------------Joomanager 1.3 2/15/2011 Joomanager 1.1.1 5/27/2010 Joomanager 1.1.0 4/06/2010 Initial Release for Joomanager 1.0 8/14/2009
Table of Contents
1. Preamble .................................................................................................................................... 1 2. Joomanager Installation ........................................................................................................... 1 2.1. Requirements 2.1.1. Server Requirements 2.1.2. Client Requirements 2.2. Installation 2.2.1 Download 2.2.3 New Install - Quick Install Method 2.2.3 New Install - Manual 3. Joomanager Module(s) Installation ........................................................................................ 11 3.2.1 Download 3.2.2 Module Installation 4. Configuring Joomanager ......................................................................................................... 12 4.1.1 Setting up Categories 4.2.1 Setting up the custom fields 4.3.1 Creating a new item 4.4.1 The Joomanager Component Configuration 4.4.2 Navigation Style Classic or Letter 5. Configuring The Modules ....................................................................................................... 12 6. Reviews (item comments) ...................................................................................................... 13 7. Email Alerts ............................................................................................................................... 15 8. RETS/MLS ................................................................................................................................ 15 9. Joomanager Template Editing................................................................................................. 16 10. Troubleshooting and FAQ............................................................................................... 17
1. Preamble
The content of this document is related to Joomanager. Joomanager is licensed under GNU/GPL All images, CSS, RETS php, and Javascript is Joomanager 2011 The Software 'Joomanager is intended for use in Joomla! (Version 1.5) (Joomla! is free Software, licensed under GNU/GPL; Joomla! is available from www.joomla.org [http://www.joomla.org])
2. Joomanager Installation
2.1. Requirements 2.1.1. Server Requirements
Joomanager has the following System Requirements: Apache 1.3.19 or above - http://www.apache.org, recommended: Apache 2.2.x PHP 5.0.x or above - http://www.php.net MySQL 4.0.x or above - http://www.mysql.com, recommended: MySQL 5.0.x Joomla! 1.5.x or higher
2.2. Installation
2.2.1 Download
The newest version of Joomanager is available under the downloads section of Joomanager.com once you are logged in.
Next, navigate to where you extracted the quick install via your web browser. The quick install splash screen should appear, continue through until you reach the below screenshot:
At the above screen be sure to enter localhost as shown, continue to fill in the following text fields with your newly created database and username information. Lastly be sure to leave the prefix "jos_" intact and click next. Follow through the rest of the site shaper setup and click the install sample data at the last screen. and you should be all set (be sure to rename/remove the installation directory after finishing the install).
2. Next head on over to the install area you will see the below screen:
3. On this screen choose which method you would like to go with, we recommend using the upload and install option, this is the most straight forward option. If you do experience any errors during the upload or install be sure to read the Installation FAQ area of this manual. Be sure you are logged in as a super administrator or will not be able to see this screen or install Joomanager.
2. Next head on over to the install area you will see the below screen:
3. On this screen choose which method you would like to go with, we recommend using the upload and install option, this is the most straight forward option. If you do experience any errors during the upload or install be sure to read the Installation FAQ area of this manual. Be sure you are logged in as a super administrator or will not be able to see this screen or install Joomanager.
4. Configuring Joomanager
4.1.1 Setting up Categories
1. Once you get Joomanager installed one of the first things youll need to do is get some categories setup. To do this head on over to the categories area of Joomanager and click the new category button as seen below:
2. After you click the Joomanager component link from the components menu, click Show Categories and you should see the below screenshot:
3. After you click the new category button youll see the following screen where you will need to enter a category name, an image if youd like and the category description:
2. After you click the new button youll see the below screen where you can create some images and description fields or whatever else you desire. This area of the Joomanager component is what gives it the flexibility we describe. You can create any number or any type of custom field here and it will show under each item that you add. The custom fields also have the following options: Searchable You can set a price range, a text box or even a drop down depending on what you require Required Published Show on list page Show on details page 3. This is also the place where you can define in what categories the custom fields show up in. This allows you to setup up your site with completely different items so for example you could list cars and all their attributes per item in one category and in another category you could have a business directory with attributes specific to a business listing.
NOTE: When adding the custom fields, they will not show in the search module unless you actually add them to an item. For example if you add 3 radio buttons as follows: 1 bedroom, 2 bedrooms and 3 bedrooms but you only set one of your items to one of these options then only this option will show in the search module. If you wanted all three to show you would need to set items to also contain 1 bedroom and the 2 bedrooms options.
2. The google maps option will automatically pull the address from the item title unless you manually enter in an address in the Google Map Address in the text field seen below. If google cant find the address an error message will be displayed above the preview/map.
2. Most of the Joomanager modules do have some sort of configuration options for example the below screenshot shows the different options available with the JM category tree module:
NOTE: As mentioned above under the 4.2.1 Setting up the custom fields. When adding the custom fields, they will not show in the search module unless you actually add them to an item. For example if you add 3 radio buttons as follows: 1 bedroom, 2 bedrooms and 3 bedrooms but you only set one of your items to one of these options then only this option will show in the search module. If you wanted all three to show you would need to set items to also contain 1 bedroom and the 2 bedrooms options.
6. Reviews
6.1.1 Reviews
1. You can enable item reviews under the item config area. You can either display the comments and reviews on the item list and item details or on both pages. A user can only add reviews when they are logged in and if you set them to manual you will then have to approve each review.
2. If you set the comments to manual under each item youll have to enable them manually by clicking the X icon next to the username below who posted the comment. You can also edit the text and click the save icon if you need to make any changes to the comments.
7. Email Alerts
7.1.1 Email Alerts
1. Email alerts are for users who login to the site and have an account. They can setup to be alerted upon the addition of new items to the site. The below screenshot shows what fields you can allow the user to be alerted on (these fields are being pulled from the custom fields you setup).
On the frontend when a user is logged in and clicks the My Alerts button next to the Add to the items the following will be show where they can enter what they desire to be alerted on and how, price equal to, less than, etc:
8. RETS/MLS
8.1.1 RETS/MLS Integration
1. The RETS/MLS feature allows you to import MLS listings into Joomanager with MLS login information. If you are a realtor or have access to a realtors login information to MLS you would simply enter this information below in Joomanager, enable and Joomanager will import into each listing as an item. In your items area of Joomanager each RETS item will be marked. Once enabled your admin area will then show the agent classes and property classes which will be imported. Once imported you can edit fields, import pictures and more to each RETS item and category.
2. Once you enable the RETS in Joomanager and items are imported they will be marked with (RETS) as seen in the below screenshot. You can add custom fields to RETS items and use the ones in Joomanager that youve added already but you cannot edit fields that are pulled from RETS although you can unpublish the RETS only fields via the show custom fields
9. Template Editing
9.1.1 Template Editing
As described in 4.4.1 Joomanager includes three areas where templates can be assigned to the components category, item list and item detail pages. The default release of Joomanager includes three different template layouts that you can assign to each of these pages. If you want to edit any of the templates they are located at the following URL of your site: /components/com_joomanager/templates
If you would like to create your own templates simply create an html file and a corresponding CSS file. Make sure both are the same name, for example, default.html and default.css. We do not provide support in editing or creating your own templates but if you have some basic HTML skills you should have no problem.
When installation is complete set them back to their defaults or to 755: root/cache root/tmp root/administrator/components root/components root/templates root/modules
10.1.2
The Joomla! 1.5 installer fails to install Joomanager with the error message "There was an error uploading this file to the server.". What's the problem? The most common reason for this problem is that the File you have uploaded is too big. The File Size Upload Limit on your Server is set too low to allow larger files to be uploaded. By default PHP allows files up to 2 MB, but this limit needs to be set to 4 MB in order to upload the Joomanager Component Install File. If you have access to the php.ini, then change the directive upload_max_filesize to "4M"and reload the server configuration. If you are running PHP in CGI mode on Apache, you can place an .htaccess file in your Joomla! root directory and place the following code inside: php_value upload_max_filesize 4M (NOTE: Some hosting providers will not allow you to change the upload size, even via the htaccess file)
10.1.3
The Installer tells me "Another component is already using the directory com_joomanager" You will need to delete the directories /site_root/components/com_ joomanager and / site_root/administrator/components/com_ joomanager. If you can't delete the directories using ftp, try the file manager for Joomla!, eXtplorer [http:// extplorer.sourceforge.net], instead.
10.1.4
The captcha image isnt showing for me on the contact form? This is related to your server. The GD library which is needed for the image generation is absent and not enabled/installed on your server. You will need to contact your host and let them know that you need the GD library running on your server.
10.1.5
Still cant figure something out? With your purchase of Joomanager you have access to our forum which is where we provide all our support. Just post your question in the appropriate board and we will be glad to help you out.