Logo

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
joomla30:swapfactory:category.categories [2015/02/12 10:38]
mircea
joomla30:swapfactory:category.categories [2015/06/26 13:33] (current)
mircea
Line 9: Line 9:
 ===== General Settings ===== ===== General Settings =====
 \\ \\
-The exchange goods system can be disabled by selecting "​Yes"​ for **Disable swap option**, this way the **Propose Swap** button ​and **Offers List** menu item will be unavailable. Users will still be able to view ads and exchange goods if they decide to by contacting other users.\\+Choose the desired ​**Date and Time format** for adson the right side of the drop-down menu you can see how the selected format is displayed on the frontend after saving the changes. "​d"​  
 +stand for Day, "​m"​ for Month and "​Y"​ for Year. “H:i” is for a 24 hour representation of time while “h:iA” is for a 12 hour. You can allow users to edit the date of their already published ads.\\ 
 +**Set expiration hour** allows users to specify an expiration hour for ads (if disabled, the ads expire at midnight).\\
 \\ \\
-There are 2 different ad types that are available for posters:\\+Enable **Show Contact information** to display users address or emails from details page or listings.\\
 \\ \\
-   * **Public Ads** - Regular ads where all the information can be seen by all users and messages are seen by everyone. Unless the admin overrides it and messages can be seen only by logged in users. +{{gallery>​ joomla30:​swapfactory:​general_settings.png }}\\
-   * **Private Ads** - The owner of the ad and his address is hidden to users. Messages can only be seen by the owner and the user that sent/​received the message+
 \\ \\
-From this area you can enable/disable these 2 types and the option to **Allow ​users to choose type of ad** if both of them are enabled. In case you won't allow them to choose ​the typeyou must choose one of them as default from the **Setup Ad type default value** option available below.\\+**Messaging on ads** will enable ​a tab on every ad where users can interact with the sellers for information regarding the items by sending messages. Enable ​**Allow ​Guest messaging** so that guests can also use the messaging systemthis will require ​**Messaging on ads** to be enabled.\\
 \\ \\
-**Allow users to set published/​unpublished status** will let posters ​to set the status of their ads. In case this option is disabledyou will have to choose ​the default value of the ads' status ​to either Published ​or Unpublished upon creating them.\\+With the messaging system enabled, it is recommended that you also enable ​**reCaptcha** to protect your website against unwanted bot spamthis will require ​the user to enter certain letters ​or numbers that a computer can not read, thus preventing automated spam messages. Further configuration for reCaptcha will be needed on the **[[#​spam_protection|Spam Protection]]** tab.\\
 \\ \\
-Set a **CRON Password** which will be used to safely call the cron script.\\+With the **Private Messaging List** option enabled messages will be visible only for the users who created them and for the ad's owner. Guest messages ​will be visible only for the ad's owner.\\
 \\ \\
-{{gallery>​ joomla30:​swapfactory:​global_settings2.png }}\\ 
 \\ \\
-Choose the desired ​**Date and Time format** for ads, on the right side of the drop-down menu you can see how the selected format is displayed on the frontend after saving the changes. "​d"​  +Enable ​**Price Field** in order to display an asking price field on every ad. You can make this field mandatory by setting ​to "​Yes" ​the **Require Price** option found below.\\
-stand for Day, "​m"​ for Month and "​Y"​ for Year. “H:i” is for a 24 hour representation of time while “h:iA” is for a 12 hour. You can allow users to edit the date of their already published ads.\\+
 \\ \\
-With **Hide Contact information** you can hide user's address or emails from details page or listings.\\+You can choose the **Decimal symbol** between a dot and a comma, this will be used before the fractional part of a number written in decimal form. The unchosen symbol will be used for digital grouping.\\ 
 +Choose how many decimals to be displayed by setting up the **Decimals number** field.\\
 \\ \\
-While on the ads pages users can interact with each other for information regarding ​the items by sending messages. You can enable this feature from here and also to allow guests to use it as well.\\ +The symbol of the currencies ​can be displayed before or after the actual prices ​by setting up the **Currency position** option.\\
-In case you enabled **Allow guest messaging** it is recommended that you also enable **Captcha** to protect your website against unwanted bot spam, this will require the user to enter certain letters or numbers that a computer can not read, thus preventing automated spam messages. Further configuration for Captcha will be needed on the **[[#​spam_protection|Spam Protection]]** tab.\\+
 \\ \\
-With the **Messages List Private** option enabled guests messages will be displayed only to other guests or to the ads' owner.\\+{{gallery>​ joomla30:​swapfactory:​messaging_price_settings.png }}\\
 \\ \\
-{{gallery>​ joomla30:​swapfactory:​messaging_settings2.png }}\\+Set a **Password** which will be used to safely call the CRON script.\\
 \\ \\
 Add the number of ads shown on each page with the **Items per page** field, in case there are more to be displayed than the set value, pagination will become available.\\ Add the number of ads shown on each page with the **Items per page** field, in case there are more to be displayed than the set value, pagination will become available.\\
 \\ \\
-Prices can be shown on ads by enabling the **Enable Price Field** option. You can even make this field mandatory by checking ​the **Price compulsory** checkbox found below.\\+**Filter includes Subcategories** will display ads from subcategories along with its parent category together in the category listing.\\
 \\ \\
-You can choose the **Decimal symbol** between a dot and a comma, this will be used before the fractional part of a number written in decimal form. The unchosen symbol will be used for digital grouping. **Decimals number** can also be set from here, add how many decimals to be displayed.\\+Enable ​**Show Countdown** in order to display how much time of availability there is left for every ad by using Javascript countdown.\\
 \\ \\
-The symbol of the currencies can be displayed before or after the actual prices by setting up the **Currency position** option.\\+Choose ​the **Order** of the ads shown on listings, by starting date or ending date.\\
 \\ \\
-**List Ads from Subcategories in parent category** will display ads from subcategories along with its parent category together in the category listing.\\+{{gallery>​ joomla30:​swapfactory:​cron_listing_settings.png }}\\
 \\ \\
-For every ad users can specify a starting date and an ending date. By checking ​the **Enable ​Ad expiration Hour** checkboxusers will also be able to specify ​the exact hour and minute when the listings will expire. In case this is disabledall the ads will expire by default at midnight.\\ +A useful feature offered by our component is that with the **Enable ​guest posting** optionvisitors ​will be able to post ads without being logged in, they will just need to insert ​the name and an email address and then edit the ad with the key received on the email entered. In case the "Pay Per Listing"​ or "Pay Per Image" items are enabled, the ad will not be published.\\
-Regarding the expiration of the ads, you can also enable a Javascript **Countdown** to display how much time of availability there is left.\\+
 \\ \\
-The availability of ads can be defined by setting up how many days the users can extend ​their ad, for how many months it can be published or for how many months ​the expired/​closed ads will be kept in archive. Adding "​0" ​for the later two means unlimited timeUsers can extend ads when expired from "My Ads" page.\\+**Enable Attachment Files** will allow users to attach files to their ads while the **Require Attachment** option ​will make the files mandatory ​for each new ad.\\ 
 +In case you enabled this feature, you can define the list of **Allowed Attachment extensions** such as zip, rar, txt, etc.\\
 \\ \\
-From this section you can also set the limit of characters for the **Short description** and to set the **Max Number of Tags** allowed per ad. Tags are an excellent way for ads to be filtered in a search, however if a user puts too many tag words his ad will pop up in every search, some people may find this annoying. To ensure this does not happen you should leave a decent limit on your tags, make the poster choose only the tags that are suited for his ad.\\+{{gallery>​ joomla30:​swapfactory:​attachments_settings.png }}\\
 \\ \\
-Choose the order of the ads shown on listings, by starting date or ending date.\\+===== Ad Settings =====
 \\ \\
-{{gallery>​ joomla30:​swapfactory:​listing_settings2.png }}\\+**New Ad posting steps** allows you to choose from 2 ways on how the new ads will be created, either a one step posting process where all the listing information is entered in one page, or another, that will require users to set the category first before completing the rest of the details.\\
 \\ \\
-An useful feature offered by our component is that with the **Enable guest posting** option, ​visitors will be able to post ads without being logged in, they will just need to insert the name and an email address and then edit the ad with the key received ​on the email entered. In case "Pay Per Listing"​ or "Pay Per Image" items are enabled, the ad will not be published.\\+Besides **[[joomla30:​swapfactory:​config.display#​access_control_list|ACL]]**,​ ads can also be actively moderated. By enabling ​the **Admin Approval** option, ​all ads will need to be manually approved by an admin on backend in order to become ​published ​on frontend.\\
 \\ \\
-**Enable Attachment Files** will allow users to attach files to their ads while the **Attachment File Required** option will will make the files mandatory for each new ad.\\ +The exchange goods system can be disabled by selecting "​No"​ on the **Swapping** option, this way the **Propose Swap** button and **Offers List** menu item will be unavailable. Users will still be able to view ads and exchange goods if they decide to by contacting other users.\\
-In case you enabled this feature, you can define the list of **Allowed Attachment extensions** such as zip, rar, txt, etc.\\+
 \\ \\
-{{gallery>​ joomla30:​swapfactory:​attachments2.png }}\\ 
 \\ \\
-===== Workflow Settings =====+The availability of ads can be defined by setting up how many days the users can extend their ad, for how many months it can be published or for how many months the expired/​closed ads will be kept in archive.\\ Adding "​0"​ for the later two means unlimited time. Users can extend ads when expired from "My Ads" page.\\ 
 +\\ 
 +{{gallery>​ joomla30:​swapfactory:​workflows_settings.png }}\\ 
 +\\ 
 +Enabling the **Wishlist** allows users to set a list of desired items they wish to trade with.\\ 
 +You can also make the field mandatory for every new ad by enabling **Wishlist Required**, as well as setting a maximum number of items allowed.\\ 
 +\\ 
 +Set the **Short description limit** as the maximum number of characters allowed in the short description field.\\ 
 +**Tags limit** defines how many tags are allowed per ad. Tags are an excellent way for ads to be filtered in a search, however if a user puts too many tag words his ad will pop up in every search, some people may find this annoying. To ensure this does not happen you should leave a decent limit on your tags, make the poster choose only the tags that are suited for his ad.\\ 
 +\\ 
 +{{gallery>​ joomla30:​swapfactory:​form_and_fields.png }}\\ 
 +\\ 
 +There are 2 different ad types that are available for posters:​\\ 
 +\\ 
 +   * **Public Ads** - Regular ads where all the information can be seen by all users and messages are seen by everyone. Unless the admin overrides it and messages can be seen only by logged in users. 
 +   * **Private Ads** - The owner of the ad and his address is hidden to users. Messages can only be seen by the owner and the user that sent/​received the message. ​
 \\ \\
-At the **Workflow settings** tab you can choose ​from 2 ways on how the listings will be createdeither a one step posting process where all the listing information is entered in one page, or another, that will require users to set the category first before completing the rest of the details.\\+From this area you can enable/​disable these 2 types and also the option to allow users to **Set the ad Type** by themselves if both auction types are enabled. In case you won't allow them to choose the typeyou must choose ​one of them as default from the **Default ad type** option available below.\\
 \\ \\
-Besides ​**[[joomla30:​swap:​installation_and_configuration#​access_control_list|ACL]]**,​ listings can also be actively moderated. By enabling ​the **Admin must approve every Listing** ​option, ​all ads will need to be manually approved by an admin on backend in order to be published.\\+**Set the ad State** will let posters to set the status of their ads. In case this option ​is disabledyou will have to choose the default value of the ads' status ​to either Published or Unpublished upon creating them.\\
 \\ \\
-{{gallery>​ joomla30:swap:workflow.png }}\\+{{gallery>​ joomla30:swapfactory:listings_settings.png }}\\
 \\ \\
 ===== Image Settings ===== ===== Image Settings =====
 \\ \\
-On the **Ads Listing Images** area you can view the current version of the graphic library and to **Disable ​Images** for listings. In case you check this option, the image gallery on the listings will be unavailable and there will be no option to upload images.\\+On the **Image Settings** tab you can view the current version of the graphic library and to **Enable ​Images** for listings. In case this feature is disabled, the image gallery on the listings will be unavailable and there will be no option to upload images.\\ 
 +**Gallery Type** option will allow you to select from 3 different gallery types that are available and selectable from the scrolldown menu: Scroll Gallery, Lytebox, and Picture Slider.\\
 \\ \\
-If the images are not disabled, you can define them on the **Listing Options** area.\\+If the images are enabled, you can define them on the **Size and Limits** area.\\
 You can add a value for **Maximum picture size**, and also to set a limit for the **Maximum number of images per listing**.\\ You can add a value for **Maximum picture size**, and also to set a limit for the **Maximum number of images per listing**.\\
-The main image of every new ad can be made mandatory by selecting ​the **Require Main Picture for listing** ​checkbox.\\+The main image of every new ad can be made mandatory by setting ​the **Require Main Picture for listing** ​to "​Yes"​.\\
 \\ \\
-**Choose Gallery Type** will allow you to select from 3 different gallery types that are available and selectable from the scrolldown menu: Scroll Gallery, Lytebox, and Picture Slider.\\ +{{gallery>​ joomla30:swapfactory:images_settings.png }}\\
-\\ +
-{{gallery>​ joomla30:swap:images_listing.png }}\\+
 \\ \\
 There are two sizes of images that can be set by you on this page. These are not for the full sized versions but for the thumbnails of them shown on the listings and ads details pages.\\ There are two sizes of images that can be set by you on this page. These are not for the full sized versions but for the thumbnails of them shown on the listings and ads details pages.\\
 \\ \\
-**Thumbnail settings** allows you to change the size in width and height of the images found on the listing pages such as **Ads list** and **My ads**. **Medium image settings** has assigned the images found on the detailed view of ads.\\+**Listing Thumbnails** settings ​allows you to change the size in width and height of the images found on the listing pages such as **Ads list** and **My ads**. **Ad Details Images** settings have assigned the images found on the detailed view of ads.\\
 \\ \\
 **(!)** The full size modal box which appear when clicking on the image is resized dynamically in Javascript according to the clients resolution.\\ **(!)** The full size modal box which appear when clicking on the image is resized dynamically in Javascript according to the clients resolution.\\
 That  means that for any resolution the browser has, the image is always centered and about 90% of the height or width available on screen.\\ That  means that for any resolution the browser has, the image is always centered and about 90% of the height or width available on screen.\\
 \\ \\
-{{gallery>​ joomla30:​swapfactory:​image_settings.png }}\\+{{gallery>​ joomla30:​swapfactory:​images_settings2.png }}\\
 \\ \\
 ===== Access Control List ===== ===== Access Control List =====
 \\ \\
 From this tab you can enable the **ACL** feature that will allow you to select specific groups of users that can publish ads.\\ From this tab you can enable the **ACL** feature that will allow you to select specific groups of users that can publish ads.\\
-Click on the **Groups allowed to post classifieds** field to add new groups, a scrolldown ​menu will appear from where you can select the groups that will be able to post new ads.\\+Click on the **Groups allowed to post ads** field to add new groups, a drop-down ​menu will appear from where you can select the groups that will be able to post new ads.\\
 \\ \\
-{{gallery>​ joomla30:swap:acl.png }}\\+{{gallery>​ joomla30:swapfactory:access_settings.png }}\\
 \\ \\
 ===== Google Maps ===== ===== Google Maps =====
Line 110: Line 121:
 **Distance Unit** allows you to choose either Kilometers or Miles as the metric system which will be used. Add specific values for the chosen metric system on the field below, these will be displayed on the actual map.\\ **Distance Unit** allows you to choose either Kilometers or Miles as the metric system which will be used. Add specific values for the chosen metric system on the field below, these will be displayed on the actual map.\\
 \\ \\
-{{gallery>​ joomla30:swap:google_maps.png }}\\+{{gallery>​ joomla30:swapfactory:Google_maps_settings.png }}\\
 \\ \\
-With **Enable Googlemaps ​in Ad Details** users will have available for every ad a **Location on Map** tab where they can check the exact location of the respective ad.\\+Enabling ​**Google Maps in Ad Details** users will have available for every ad a **Location on Map** tab where they can check the exact location of the respective ad.\\
 If enabled, you can define the width and height of the map and select which type of map will be used: Roadmap, Hybrid, Satellite or Terrain.\\ If enabled, you can define the width and height of the map and select which type of map will be used: Roadmap, Hybrid, Satellite or Terrain.\\
 \\ \\
-{{gallery>​ joomla30:swap:google_maps2.png }}\\+{{gallery>​ joomla30:swapfactory:Google_maps_settings2.png }}\\
 \\ \\
 ===== Spam Protection ===== ===== Spam Protection =====
Line 124: Line 135:
 Furthermore you can choose one of the four available **Themes** for ReCaptcha: Red, White, Backglass or Clean.\\ Furthermore you can choose one of the four available **Themes** for ReCaptcha: Red, White, Backglass or Clean.\\
 \\ \\
-{{gallery>​ joomla30:swap:recaptcha.png }}\\+{{gallery>​ joomla30:swapfactory:recaptcha_settings.png }}\\
 \\ \\
-From the **Email Spam Protection** area you can enable the email protection ​by checking the checkbox ​and selecting ​which type of plugin you wish to be used.\\+From the **Email Spam Protection** area you can enable the email protection and select ​which type of plugin you wish to be used.\\
 **Recaptcha Mailhide** plugin works the same way as regular ReCaptcha, but it is used when users want to see email addresses. Other email protection methods are **Smarty** and **Joomla**. Smarty obfuscates the source code with Javascript, while Joomla simply hides the email address.\\ **Recaptcha Mailhide** plugin works the same way as regular ReCaptcha, but it is used when users want to see email addresses. Other email protection methods are **Smarty** and **Joomla**. Smarty obfuscates the source code with Javascript, while Joomla simply hides the email address.\\
 \\ \\
 In case you choose ReCaptcha Mailhide, you have to add a public and a private key, clicking on **[[http://​www.google.com/​recaptcha/​mailhide/​apikey|Get it here]]** will take you to ReCaptcha'​s website to obtain the public and private keys, copy/paste them on the provided fields and click on **Save** when you are done.\\ In case you choose ReCaptcha Mailhide, you have to add a public and a private key, clicking on **[[http://​www.google.com/​recaptcha/​mailhide/​apikey|Get it here]]** will take you to ReCaptcha'​s website to obtain the public and private keys, copy/paste them on the provided fields and click on **Save** when you are done.\\
 \\ \\
-{{gallery>​ joomla30:swap:email_spam_protection.png }}\\+{{gallery>​ joomla30:swapfactory:recaptcha_settings2.png }}\\
 \\ \\
 ===== Terms and Conditions ===== ===== Terms and Conditions =====
Line 139: Line 150:
 However, by leaving the text field empty this will no longer be required on the frontend, hiding the field completely.\\ However, by leaving the text field empty this will no longer be required on the frontend, hiding the field completely.\\
 \\ \\
-{{gallery>​ joomla30:swap:terms.png }}\\+{{gallery>​ joomla30:swapfactory:terms_and_cond.png }}\\
 \\ \\
 ===== Restrictions ===== ===== Restrictions =====
Line 148: Line 159:
 Add a value which will be applied as a **Global User Limit** for ads. In case there are no other custom limits added, this will be applied to all the users on your website. Leave blank for unlimited ads.\\ Add a value which will be applied as a **Global User Limit** for ads. In case there are no other custom limits added, this will be applied to all the users on your website. Leave blank for unlimited ads.\\
 \\ \\
-{{gallery>​ joomla30:swap:restrictions.png }}\\+{{gallery>​ joomla30:swapfactory:restrictions_settings.png }}\\
 \\ \\
 On the **Custom Limits per User Group** you can select various user groups and add the limit value in the text field below. Multiple limits for different groups can be added by clicking on Add new limit. This is more relevant then the global limit but less relevant than limits per user.\\ On the **Custom Limits per User Group** you can select various user groups and add the limit value in the text field below. Multiple limits for different groups can be added by clicking on Add new limit. This is more relevant then the global limit but less relevant than limits per user.\\
 \\ \\
-{{gallery>​ joomla30:swap:restrictions2.png }}\\+{{gallery>​ joomla30:swapfactory:restrictions_settings2.png }}\\
 \\ \\
 On the **Custom Limits per Users** area you can limit the amount of ads for certain users. Clicking on the **Users** field will display a dropdown menu where you can select one or more users, add the value below and click on **Add new limit** in case you wish to add a different limit to other users.\\ On the **Custom Limits per Users** area you can limit the amount of ads for certain users. Clicking on the **Users** field will display a dropdown menu where you can select one or more users, add the value below and click on **Add new limit** in case you wish to add a different limit to other users.\\
 \\ \\
-{{gallery>​ joomla30:swap:restrictions3.png }}\\+{{gallery>​ joomla30:swapfactory:restrictions_settings3.png }}\\
 \\ \\
 ===== System Info ===== ===== System Info =====
 \\ \\
-The **System Info** tab is implemented to provide basic information about the cache directory, upload directory or configuration file. These are required in order for the component to run properly, so make sure everything is green after installing Swap Factory.\\+The **System Info** tab is implemented to provide basic information about the cache directory, upload directory or configuration file. These are useful ​for debugging if any issues arise. The component handles the configuration file permissions itself, even if the configuration file might be Unwritable, ​the component ​will still be able to save the configuration and restore previous permissions.\\
 \\ \\
-{{gallery>​ joomla30:swap:system_info.png }}\\+{{gallery>​ joomla30:swapfactory:system_information.png }}\\
 \\ \\
 ====== Currency Manager ====== ====== Currency Manager ======
Line 170: Line 181:
 Clicking on **Refresh conversion** will update the rates using Yahoo conversion.\\ Clicking on **Refresh conversion** will update the rates using Yahoo conversion.\\
 \\ \\
-{{gallery>​ joomla30:swap:currency_manager.png }}\\+{{gallery>​ joomla30:swapfactory:currency.png }}\\
 \\ \\
 Clicking on **New** will allow you to add new currencies, simply add the currency abbreviation and a conversion rate. In case you don't know the conversion rate you can leave the field empty and click on **Refresh conversion** afterwards to update it. The CRON script also updates currency exchange rates according to Yahoo, check the CRON documentation for more information.\\ Clicking on **New** will allow you to add new currencies, simply add the currency abbreviation and a conversion rate. In case you don't know the conversion rate you can leave the field empty and click on **Refresh conversion** afterwards to update it. The CRON script also updates currency exchange rates according to Yahoo, check the CRON documentation for more information.\\
Line 182: Line 193:
 The component supports unlimited category levels.\\ The component supports unlimited category levels.\\
 \\ \\
-{{gallery>​ joomla30:swap:​categories.png }}\\+{{gallery>​ joomla30:swapfactory:​categories.png }}\\
 \\ \\
 To add multiple categories at once use the **Quick add** button found at the bottom of the page. The Quick Add option allows you to add more categories along with their sub categories at once, they have to be written in a certain way to be properly arranged: write the main category first, on the next line leave one space and write a sub category, under it you can write another and so on. If you want to add another main category do not leave any space in front of it and then continue as you did with the others.\\ To add multiple categories at once use the **Quick add** button found at the bottom of the page. The Quick Add option allows you to add more categories along with their sub categories at once, they have to be written in a certain way to be properly arranged: write the main category first, on the next line leave one space and write a sub category, under it you can write another and so on. If you want to add another main category do not leave any space in front of it and then continue as you did with the others.\\
Line 208: Line 219:
 \\ \\
 ---- ----
-**(!)** Documentation based on **Swap Factory** version **1.4.3** +**(!)** Documentation based on **Swap Factory** version **1.5.2**