Swap Factory offers an easy to use and easy to manage exchange system of the goods added by users as classified ads. It gives you, as administrator, access to many settings and features that are configurable from the backend. While the component is installed with default settings allowing it to be up and running almost instantly, it still needs some certain settings in order to be used at its full potential.

To access most of the Swap Factory backend options go to Swap Factory's Control Panel and click on 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.

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.

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 type, you must choose one of them as default from the Setup Ad type default value option available below.

Allow users to set published/unpublished status will let posters to set the status of their ads. In case this option is disabled, you will have to choose the default value of the ads' status to either Published or Unpublished upon creating them.

Set a CRON Password which will be used to safely call the cron script.

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" 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.

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.
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 tab.

With the Messages List Private option enabled guests messages will be displayed only to other guests or to the ads' owner.

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.

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.

The symbol of the currencies can be displayed before or after the actual prices by setting up the Currency position option.

List Ads from Subcategories in parent category will display ads from subcategories along with its parent category together in the category listing.

For every ad users can specify a starting date and an ending date. By checking the Enable Ad expiration Hour checkbox, users will also be able to specify the exact hour and minute when the listings will expire. In case this is disabled, all the ads will expire by default at midnight.
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 time. Users can extend ads when expired from "My Ads" page.

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.

Choose the order of the ads shown on listings, by starting date or ending date.

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.

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.
In case you enabled this feature, you can define the list of Allowed Attachment extensions such as zip, rar, txt, etc.

At the Workflow settings tab you can choose from 2 ways on how the listings 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.

Besides 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.

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.

If the images are not disabled, you can define them on the Listing Options area.
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.

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.

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.

(!) 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.

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.

For each ad a separate location can be specified using the Google Maps system. Users can view the map with all the active ads and their locations on the user menu's Ads on map page. Besides this, users can also view the location of a specific ad from the details page of it.

From this tab you can configure the Google Maps integration, this is needed before it can be displayed on frontend. To have this feature working you will need an API key, click on the Get API Key link provided and follow the instructions found there. Afterwards, copy/paste the link in the field and click on Save.

Now that the map can be displayed, you can set the default position of it by clicking on Pick Position or adding the latitude and longitude coordinates manually. Besides this, you can also set the default zoom level of the map from 1 to 10 on the Google Maps Zoom Level field.

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.

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.
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.

With ReCaptcha you can avoid 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.
In case you enabled this feature from the General Settings tab, you will have to acquire a public and a private key for it to work. Click on Get it here link provided which will redirect you to ReCaptcha's website. Follow the instructions found there and copy/paste the public and private keys.

Furthermore you can choose one of the four available Themes for ReCaptcha: Red, White, Backglass or Clean.

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.
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 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.

This tab comes with a simple WYSIWYG editor where you can add your website's Terms and Conditions.
When a user creates an ad, he must agree to the Terms and Conditions, such as: Privacy, Confidentiality, Limitations or Payment method.
However, by leaving the text field empty this will no longer be required on the frontend, hiding the field completely.

From the Restrictions tab you can set a limit of ads globally, per user groups or per user.
The priority of the limits is: User > Group > Global. This means that, for example, even if there is a global limit of 5 ads but the respective user has a custom user limit set for him of 10 ads, the later one will be prioritized, ignoring the global limit and allowing the user to add a maximum of 10 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.

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 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.

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.

Currency Manager page allows you to manage the currencies used for ad prices or for buying payment items.
You can select a default currency so that when payments are made for payment items with other currencies it will convert them and recalculate the prices.
Clicking on Refresh conversion will update the rates using Yahoo conversion.

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.

Ads can be assigned by users to various categories depending on the backend configuration.
Category Management area allows you to create categories along with sub-categories or to sort the order of the already existing ones.
The component supports unlimited category levels.

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.

Swap Factory comes with many menu items that you can manage by adding or removing them from the user menu.
Here is a list of the items that are available on the Swap Factory menu upon the installation:

• Ads List - Shows lists containing all the active/expired/archived ads.
• Offers List - Shows lists of all the offers to trade goods that are either received, submitted or closed.
• Categories - Shows a list with all the available categories.
• Ads on map - Shows Google Maps with the location of all the ads.
• Search - Shows search forms that can look up after a certain keyword, price or user.
• New Ad - Shows a form for users to post new ads.
• My Ads - Shows a list with all the ads posted by the logged in user.
• Watchlist - Shows all the ads or categories added to favorites by the logged in user.
• Profile - Shows a page where the logged in user can view and edit his profile, check his payment balance, and more.

(!) Documentation based on Swap Factory version 1.4.3