Setting up Mycelia

This takes about half an hour once you have your Phorest API details. Nothing changes in your shop until you switch dry run off in step 6.

Prefer to watch? The setup video is on the Getting started page. It was recorded on an earlier version: the screens have changed since, the steps have not.

1. What you need

  • A WordPress site with WooCommerce (WordPress 6.0, WooCommerce 7.1 and PHP 7.4 or later).
  • A Phorest account.
  • Phorest API credentials. See step 2.
  • Your Mycelia license key, from your account on this site.

2. Get your Phorest API credentials

Email api-requests@phorest.com from the salon's own email address and ask for third-party API access for your business. If you are a web designer working for the salon, ask the salon to send the email and copy you in.

Phorest replies with three things:

  • Username. It looks like global/name@example.com. Copy all of it, including global/.
  • Password.
  • Business ID. A string of letters and numbers.

You do not need a branch ID. Mycelia lists your branches for you in step 4.

Phorest can also set you up with a development account that has dummy data. Ask for one if you want to test without touching real stock.

3. Install the plugin

  1. Download the latest zip from your account.
  2. In WordPress go to Plugins, Add New, Upload Plugin, choose the zip and activate it.
  3. Open Mycelia in the admin menu. Under Mycelia license, paste your key and activate it.

4. Connect to Phorest

Under Phorest connection:

  1. Choose the Region your Phorest account is in: Europe, or the US, Canada and Australia. If Phorest gave you an API URL, pick the region whose address matches it.
  2. Enter the Username, Password and Business ID exactly as Phorest sent them.
  3. Press Save API configuration, then Validate connection.
  4. Choose your Branch from the list and save again.

If validation fails, the message says which part Phorest refused. The usual mistakes:

  • Extra text pasted into the API URL. It must end in /third-party-api-server/api/ with nothing after it.
  • A missing global/ at the start of the username.
  • A space at the start or end of the password or Business ID.

5. Decide how products are matched

Mycelia matches a Phorest product to a WooCommerce product by the WooCommerce SKU. Under Synchronisation, Phorest identifier chooses what the SKU must equal:

  • Product ID. Phorest's own ID for the product. Best for a new shop: let Mycelia create the products and it sets the SKUs itself.
  • Barcode. The barcode on the product in Phorest. Best for a shop that already has products, since their SKUs are often the barcodes already.

If your shop already has products, make sure each SKU equals the Phorest barcode before you sync for real. Otherwise Mycelia sees no match and creates a second copy of each product. On the Barcode setting every retail product needs a barcode in Phorest. Products without one are left out and listed.

Then choose what to sync: stock, names, prices, category and brand.

6. Do a dry run, then a real sync

Dry run is on when you first install. Press Pull & merge from Phorest. Nothing is saved. The result tells you:

  • New products. Phorest products with no matching SKU. A real sync would create these.
  • Name, price and stock changes. What would change on products that did match.
  • Skipped. Products with no barcode, by name.

If you expected matches and see mostly new products, go back to step 5. When the numbers look right, switch Dry run off under Advanced and press Pull & merge from Phorest again.

7. Send orders to Phorest

Under Upstream to Phorest:

  1. Switch on Push orders to Phorest.
  2. Choose a Web sales agent. Orders are recorded against this staff member. Creating one in Phorest called "Web shop" keeps web sales apart in your reports. Press Refresh from Phorest if a new staff member is not listed.
  3. Choose the Payment method web sales are recorded under.
  4. If you charge for delivery, create a product in Phorest called "Shipping" and choose it as the Shipping product.

Place a test order. The order notes in WooCommerce say whether Phorest accepted it and in which branch.

8. Schedule the sync

Under Scheduled sync, switch it on, choose how often and between which hours. This needs an active license. On a busy site, or if you prefer your own cron job, choose Self-managed and call the address shown there. There is more on this under Scheduling.

9. Optional extras

  • Branches. For a business with more than one Phorest branch. Match each WooCommerce pickup location to a branch.
  • Gift vouchers. Sell Phorest gift cards and accept them at checkout.

10. Going live from a staging site

Deactivate the license on the staging site, then activate it on the live one. If the license refuses, open a ticket and we will reset it.

If you get stuck

Open a support ticket and tell us what the settings page or the order note says. The FAQ covers the common questions.

Mycelia

Just as mycelia in a forest plays a vital role in the transfer of nutrients & information between plants and the soil, Mycelia helps to transfer information, sales data, and customer information between your Phorest system and your Woocommerce/WordPress website.

Copyright © 2023 to 2026 403Page Labs.
All rights reserved.