This tutorial covers the features added in versions 1.4.x - 2.x.x

For versions prior to 2.x.x please check out the info below!

Go to the upper Menu in the Joomla backend. There choose "Extensions"/"Install/Uninstall". In the field area Upload Package File click on Browse and choose from your Computer HDD the ZIP file. After you choosed the file click "Upload File & Install".  When finishing the installation the following screen will appear.


You can configure your component by choosing the proper settings regarding images, currencies, time display, time format, etc. 


CRON or PSEUDOCRON has to be configured also. These are two different services not related to our component. The component just make usage of these services by for example in closing expired auctions, sending emails, updating proxies, etc. To configure the CRON services please check our documentation .

The CB Plugins will be automatically installed if the Auction Component will be installed after Community Builder. If Auction Factory will be installed before CB, then you will have to install manually by going to the Auction Component Settings, on tab Other Settings, just click on the button CB Plugins

CB Integration. Here you can create CB fields, like city, country, bidder, seller, paypal, etc. and integrate them in the component from the Auction Component Settings, CB Integration.

ACL. You can define an existing Joomla User Group as Bidder or Seller. Please check the checkbox "Enable ACL" available under the "Settings"/"ACL" tab. For more informations please check also this Documentation .

Paypal Settings can be configured under "Manage Payments"/"Payments Methods Config". Here the first thing is to change the Paypal adress! If you want to test it and you have a sanbox paypal adress, then on the use sandbox select choose Yes. On a live site this option should be set up to No.

Pay per Featured Auctions/Listing. Auctions can be featured meaning that they will have a special status on the listing like Bronze, Silver, Gold and they will be highlighted accourding to the CSS. In order to benefit for a featured auction the auctioneer have to pay a certain amount. After the Payment is made, the webmaster can enable the new status by approving the payment. From "Manage Payment"/"Payment Items" the webmaster can set different tarifs for the featured auctions. The same procedure applies to the Pay per Listing feature.

In order to have access on the frontend to the component you have to publish the Auction Menu in the "Module Manager".


If you want to receive comissions for every succesful transaction, you have to enable the Commission plugin and configure it. Here you can set the percentage the site will gain.


The auctioneer will be charged if the auction will have a winner with the setted percentage of the winning bid. The status (balance) of each auctioneer debts will be displayed in his personal page profile. There a link will appear for each currency to proceed with the Paypal payment. Also a notice is showed that the commissions are separately for each currency and a bigger payment for an amount will not complete the balance of another currency debt.

To customize the look in order to obtain a matching look to your site template or just to customize the look of the Auction Factory Component please continue with this documentation. Auction Factory includes a very powerfull templating engine - smarty. Making use of smarty, the auction engine will provide to this engine some pre-filled objects and arrays of objects that are relevant to the current page displayed. Also all language constants defined in Auction Factory can be accessed in the template. We advice against writing hard coded text into the Templates, since this would render the multi language concept useless. If you do not care about the ability to translate your site, then you can do as needed.

Language files are placed in the 'lang' directories of the components. For those of you who wants to alter a language file here is a small example of how to do it. All you have to do is replace the words marked in red, into a new file and changethe default language file.

define('but_close_window','Close this window!');

For more information regarding the language files please check also the forum under:,com_smf/Itemid,40/topic,1218.0/,com_smf/Itemid,40/topic,921.0/



Infomation for versions PRIOR 2.x.x:

If the component will be installed in Joomla 1.5.x, LEGACY Plugin must be enabled! Otherwise the component will not be installed.


After activating the Legacy Plugin please proceed with the standard install mode.



Revised "Auction Factory" version 1.5.x.