Getting Started with Xeroom

Xeroom Free Trial Licence

In order to properly evaluate Xeroom we provide you with access to a full Premium licence that will run for free for a few months.  There are no limitations to the number of transactions or functionality. The licence key TRIALJUN20  which runs until the 30th June 2020. You will need this licence key during the installation procedure to activate Xeroom.


Getting Started Procedure

Xeroom connects three different and complex software systems (WordPress, Woocommerce and Xero) together along with a multitude of 3rd party plugins and themes on both platforms, all of which are constantly changing.  We have tried to make this challenge as simple as possible to install, with detailed step-by-step instructions but it does require a good knowledge of IT and Woocommerce plus a basic knowledge of Xero along with a good dose of patience to do it!  If you do not possess these then we don’t recommend you attempt it but instead use our low-cost fixed-price installation “Jump Start” service which is less than the cost of an hour’s time of an IT or accounting professional.

  1. Requirements – You will need a recent version (ie no more than 3 months old) of WordPress site with the latest version of the Woocommerce plugin installed and configured. Ideally a fresh clean test site or better still a clone of your current live site with all the non-core Woocommerce plugins removed so you can ensure any issues are fixed before interfering with your live site.  This can be easily done using the All-in-one WP Migration plugin.  You can use it on your live site and delete the test orders afterwards but we don’t recommend it as there may be conflicts with one or more of your plugins.
  2. Check ioncube – Before you start please check that you have the ioncube loader installed on your server (ask your host, they should install it if it is not there as it is free and widely used) which should be the latest version 10.3 (10.2 will also work).  This enables the encrypted code to be decoded and work. Note: We are abandoning the use of ioncube with the next release at the end of June 2020.
  3. Check php version –  Your php version should be 7.2 or 7.3.  We do not support any earlier versions. The latest version is v7.4 released in Nov 2019 but is not widely used, it is not on our hosts yet and we do not support it yet.
  4. Download – Go to our downloads page to download the latest version of the plugin. This is a zip file that you simply upload to your site using the Menu/Plugins/Install new page.  Please deactivate and delete any previous versions of Xeroom first.  Any old settings will still be kept in the database.
  5. Installation – Then follow the detailed step-by-step installation and configuration instructions on the menu above.  If you prefer we can do this for you as a simple installation for $97 – see below.
  6. Xero API Keys – Note the following: Xero are deprecating Oauth1a which will cease at the end of the year.  Xeroom version 2.10 has Oauth2 compatibility and is due to be released at the end of June 2020.  Oauth 1a is still available and working so please use this as it is simple to upgrade to OA2.  For more info please see the post about it   
  7. Xero Trial – For the trial we recommend that you take a 1 month free trial of Xero itself and use that otherwise you will clutter up your production instance of Xero with random test transactions. Note:  Xeroom does not currently support the multi-currency version of Xero.  Beware that when the Xero trial ends you will not have access to your test data.
  8. Testing – We suggest running a range of different test transactions on different products with customers from different countries.  Once the orders are placed their respective invoices can be seen within Xero and checked against the order figures in Woocommerce.
  9. Support – For support issues please check our support page for immediate answers as most of the common problems are detailed there. If your query is not addressed then please open a support ticket with the form giving us as much of the requested info as is easily possible so that we can assist you quickly.
  10. Presales Assistance  – Our free support is by email so we can keep our prices low otherwise we would have to increase them to cover this cost.  If you need dedicated presales assistance/time on telephone calls/onboarding/in-depth requirements analysis then this is available for $97/hr rounded up to the next 15 min which can be ordered from our shop. 


Jump-Start Service

If you are migrating from another Xero plugin or just want to get cracking asap without bothering with a free trial then we can jump-start you and install Xeroom straight onto your live site with no delays.  This is quicker than first checking on a test site but do be aware that it can make troubleshooting more difficult if there are any problems or conflicts.

1. Place order – To proceed please check items 1 and 2 above and then order the licence with installation (either simple or complex) here   Once you have ordered it you should get an immediate confirmation with your licence key. 

2. Complete Checklist: In order for us to provide the installation quickly please complete the instructions in the installation checklist and email the details as a Word document to me at [email protected] installation checklist It would be helpful to know what the problems were with the previous Xero plugin to ensure that we can try to resolve them at the start.  We aim to do the install within 48 hours of receiving your data checklist back. Your data is protected by our legal Non-Disclosure Agreement that can be downloaded here.