Archive for October, 2010

transactor_paypal

October 18th, 2010

The following article will explain how to setup the transactor_paypal plugin to allow Paypal payments to be made using the tt_products typo3 extension.

The first step is to buy and install the transactor_paypal plugin from ttproducts.de Once you’ve done that it’s time to setup the test Paypal Accounts.

Paypal

Paypal’s developer network has moved to www.x.com. You need to setup a buyer account (with funds) and a seller account.

Templates

The following additions need to be made to the Template setup for the Shop. Firstly, setup a Templates Sysfolder for the Shop. Add ane extension template to that Sysfolder and name it ‘Paypal.’ To the ‘Setup’ field add the folllowing code:

lib.transactor_paypal {
   extName = transactor_paypal
   extWww = www.paypal.com
   extTitle = PayPal Website Payments Standard
   extInfo = PayPal enables any business or consumer with an email address to securely, 
conveniently, and cost-effectively send and receive payments online. extImage = EXT:transactor_paypal/res/paypal_euro.gif gatewaymode = form formActionURI > paymentMethod = paypal_webpayment_euro currency = EUR templateFile = EXT:transactor/template/transactor.tmpl useBasket = 1 conf { } }

Once that has been installed, you can then edit the config of the main root template for your shop.

Constants:

plugin.tt_products.paymentActivity = verify

Setup:

plugin.tt_products {

  payment >
  payment {
  90.title = Paypal Gateway
  90.handleLib = transactor
  90.handleLib < lib.transactor_paypal
  90.image.file = EXT:transactor_paypal/res/paypal_euro.gif
  }
}

Also, in the Includes tab, under 'Basis' templates, add the Paypal Template from your Templates SysFolder.

Edit products.tmpl

On the Filesystem, you also need to edit your products template. Add the

###MESSAGE_PAYMENT_SCRIPT###

inside the subpart

###BASKET_PAYMENT_TEMPLATE###

Empty your cache, reload your site – and test it all out.

You may need to play with your templates to get things appearing as you wish, but that should be mostly there.

tt_products webshop on typo3

October 11th, 2010

Typo3 is a Content Management System that provides alot of functionality out of the box, as well as a vast catalogue of both user contributed and commercial extensions.  It’s templating system makes it very easy to integrate legacy sites.  This is a tutorial documenting the installation and setup of tt_products, an ‘Ecommerce’ extension to typo3.

After purchasing tt_products from http://www.ttproducts.de/ I downloaded the t3x file and installed it onto the server using the ‘Import Modules’ feature of the typo3 Extension Manager.  It asks to create a new table in the typo3 database, and install a few extensions that it needs, and others which are recommended.  Knowing that I wanted a fully featured ecommerce shop, I installed them all.

Once that was done, the next step was to download the addons_tt_products extension from the typo3 Extension Manager.  As tt_products has grown over the years, it was necessary to maintain the templates outside of the main tree.  These are available in this new extension, so install that to get your templates.

Once that is downloaded, I copied the products_template.tmpl to the fileadmin/template/ directory (your location may be different).   I then had to setup a new template for the Shop plugin to use.

To create a new page (essentially the ‘root’ of your shop,) you must create a new page in your navigation structure in the typo3 backend.  Once the page has been created, give it a sensible name, unhide it then ‘save&close’ it.

Create a new template on the new page, by right-clicking on the page in the navigation, and selecting ‘template.’  Enter a sensible template title, and under Constants: enter the following (exchanging the path for the path of your template file):

plugin.tt_products.file.templateFile = fileadmin/template/products_template.tmpl

Save the template and then Clear the Cache.

Once that has been completed, select ‘Template’ from the Web Module list, and click on the Shop ‘root’ page.  This should provide you with the ‘Template Information’ page.  At the bottom of this page, it says ‘Click here to edit whole template record.’  -  DO IT.

On the ‘Includes’ tab – there is an option for ‘Include static (from extensions): on the right hand side, clikc ‘Shop System CSS Styled (tt_products).  This should move it to the ‘Selected Box’.  Once this is done, you can save&close and Rebuild the Cache.

THIS IS AN IMPORTANT STEP THAT WILL BREAK THE SITE IF NOT COMPLETED

To create the Shop, you have to now insert the Shop Plugin into the ‘Page Content’ of your page.  As a start I’ll show you how to create a simple shop.

Select the ‘Page’ view in the web module list, and click on your Shop ‘root’ page to edit it.

Create a ‘content element’ on the page, and on the second tab, select the ‘Shop Plugin’ as the plugin you’d like to insert.  If you’ve got the FlexForms plugin enabled, then you should be able to select ‘Product: List’ from the list of views on the right hand side.  Leave the other fields blank.

At the bottom of the Page is a ‘StartingPoint’ – this is essentially the ‘root’ folder for all your products.  However, we haven’t created any products or categories yet – so filling this is going to have to wait.  Save&Close the page.

For a simple shop, there are only going to be a few products and categories, so that is all I intend to cover here.

To add your Products and Categories, you need to create a folder to put them in.  I added mine by creating a SysFolder underneath my Shop ‘root’ called Products.  Once you’ve created the SysFolder, select ‘List’ view from the Web Modules, and select the Products folder you’ve created.  On the right hand side of your view it will be empty. 

Create new content on the Right Hand side by clicking the small ‘add’ icon. Select ‘Product category’ from the list of Content Types, then fill in the relevant fields on the first tab.  Don’t bother with theother tabs for now.

Do the same but for ‘Products’ instead of ‘Product categories’ to create the products you want. Just create a few for now, to get the gist of how the System works.

To create a simple site structure, you’ll need to add three more pages underneath your Shop ‘root’ page.  These are:

  • Shopping Cart
  • Checkout
  • Order Status

These are just standard pages – simple to setup.

To make these pages function properly, you’ll need to add the Shop Plugin to their page content.  If you’re using the FlexForms extension, then instead of a CODE box, you’ll be able to select what you want to display for each page.

  • For Shopping Cart, you’ll display BASKET (FlexForms = Basket: Shopping Cart)
  • For Checkout you’ll display PAYMENT,FINALIZE,INFO (FlexForms = Basket: Order Review & Payment)
  • for Order Status you’ll display TRACKING (FlexForms = Orders: Tracking)

You can now edit your root page, and under the Plugin Tab, set your Startingpoint to the Products folder.

The site will now work, but you’ll need to enable Order Tracking by editing your template.  Add the following information to the template file:

http://[www.yourdomain.de]/index.php?id=[uid_of_your_tracking_page]&type=1&tracking=###ORDER_TRACKING_NO###

There you have it.  A tt_products site all setup and working.

10K Run

October 3rd, 2010

Today I took part in the Heaton Park, Cancer Research UK, 10K run. 

Having woken up at 7am, I supped on lots of Lucozade and had a banana.  Awesome start to the day. Looking out the window, it was chucking it down with rain.  I know Manchester hasn’t got the best reputation when it comes to fine weather, but today was probably the wettest for months.  I drove over and picked up Daniel & Jenna, then headed over to Heaton Park.

When we got there, despite the delay in finding a place to park, we made it to the field in time for one last ‘toilet stop’ and joined in the amusing warm up.  By the end of this we were absolutely drenched from the rain above, and squelching from the mud below.  I was so glad to have bought myself a pair of tight-fitting running socks the day before.

The run started, and after 5 minutes of jogging in a fairly tight pack through narrow paths (and lots of mud) the field started to break up and I had the opportunity to overtake a few of the more casual joggers.  The run took us over bog and quagmire, and despite a puddle only being about 3 inches deep and 5 meters long on the way out, the torrential rain meant that running back through the same path on the 8km mark, it was 50 meters long and up to 6-8 inches deep in places.  I didn’t apply to run a triathalon, but it wasn’t far off being able to swim!

I got to the last km and was starting to feel it.  The penultimate 500 metres seemed to go on forever, and on the 500 meter mark I got overtaken by a guy who’d picked up his pace.  Not feeling like I had much in the tank, I didn’t want to keep pace with him, but figured it would be a sensible thing for me to do.  I’m glad I did, because along the finishing straight I saw the clock, and wanting to finish under 54 minutes, I managed to find the energy to break into a sprint.  I passed him with seconds to spare, and finished in 53 minutes 43 seconds.

It was a tough race, the weather persisted down throughout the whole of the race.  However, I really enjoyed it, and the sense of achievement at the end of it was much more acute than I’d expected.

Training for this has been fun, and having not run much before I’m looking forward to the next chance I have to get out and compete in another 10k.  I don’t think I’ll be increasing the distance in the next few months, but hopefully will get a chance to improve upon my time, and run in nicer weather.

Thanks to everyone who sponsored me; it carried me through knowing I had support – and I’m glad that the money raised is going to such a great cause as Cancer Research.

Route & Donate