Label Woosignal: Documentation Version: 1.0

Introduction


Welcome to Woosignal! Get familar with how Woosignal works and explore the features available.
If you have any questions please feel free to contact us

Requirements


To quickly get setup, you'll need to ensure that you have the below requirements.

  • WordPress 4.4+

    Woocommerce Store 3.0+

    Xcode 9+ (Download from the App store for Mac)

Folder Structure


Download and extract the zip. You will find the structure as follows:

App Contains the app, open the "Label.xcworkspace"
Label Woocommerce Plugin Contains the Label WordPress plugin
Readme.txt Information for changelog & version

Connecting Woocommerce


Follow the below steps to connect your Woocommerce store:

  • Login into your Woosignal account (or create an account if you are new).

  • On the Dashboard, if you have not connected your store, it will display "Offline". This means you will need to connect your Woocommerce store, select "connect" and add the url to your Woocommerce store e.g. https://www.outdoorshoes.com once added, select "Connect store".

  • It will ask for an admin user to login so Woosignal can be authorized to connect with your Woocommerce store. Once complete, if all has gone successful, your dashboard should show "Online" which means your store is now connect!

Connect Label App


If you have followed the above steps, you should now be able to connect your app.
Using Xcode, open the "Label.xcworkspace" in the package. Once open need to open the LabelCore file (inside Core [EDIT APP INFO]).

This file contains configuration settings for the app

  • Linking your Woocommerce store

On the Woosignal dashboard you should have "Apps" on the left sidebar, select it and generate a appKey by clicking "Generate new key". This will create a key for the app to use, copy it and go back to the app.

Inside the "LabelCore" file in Xcode, look for appKey and update the value like so

let appKey = "paste the app key here"

Once added you should be able to run the app in Xcode by clicking the run icon at the top

Note: Products - If you are on the free plan it will only display 20 products so if you can't see products in categories that's the reason why. View our plans to learn more.


Currency


To change the currency symbol throughout the app, first open LabelCore in Xcode and look for the following variable

let appLocaleID:String! = "en_GB"
let appLocaleID:String! = "your locale id from https://gist.github.com/jacobbubu/1836273"
Woocommerce Payment Currency

To change the currency for Woocommerce orders find the following variable inside LabelCore in Xcode

let currencyCode:String! = "GBP"
let currencyCode:String! = "Find your currency code, here's a list"

Multilingual


To change the languague throughout Label you will need to use the Localizable Strings in Xcode, we have created one in English that can be referenced for new Localizable Strings, here is a guide to learn how it works

Login


If you want to use the login feature in the app you need to ensure that you have installed the following plugins on WordPress first:

  • JSON API
  • JSON API Auth
  • JSON API User
  • Label Plugin (Included in package "Label Woocommerce Plugin")

Once installed, please ensure that you have activated they in your WordPress settings.

Last part

Make sure the wcUrl in "LabelCore" is set to your domain

let wcUrl:String! = "http://yourdomain.com/"

Make sure useLabelLogin is enabled like the following

let useLabelLogin:Bool! = true

Next, go to Settings on WordPress > JSON API > activate the following : "Core", "Auth" and "User"

You should now be able to run the app and use the LabelLogin feature

Apple Pay


To use Apple Pay you must have a developer account with Apple, learn more here.

  • 1). Visit apple developer website via http://developer.apple.com and select your account

    On the account overview, select "Certificates, Identifiers & Profiles".

  • 2). Create a merchantID

    On the left sidebar look for Merchant IDs inside Identifiers and select it.

    Inside here you will need to create a merchant Id by clicking the plus icon in the corner, add a Description and Identifier and continue. You should copy the ID and paste it to the variable merchantID in LabelCore

    let merchantID:String! = "paste merchant id here"

  • 3). Next inside the Xcode project, click the Label right at the top left sidebar and here you'll need to edit the compatibilities of the app. Find Apple Pay and turn it on and select the merchant id you created from the list.

Stripe


To connect Stripe to Label you will need to first login to Woosignal, on the dashboard, you will need to connect your Stripe account here

Follow the guide on Stripe, this will authorize Woosignal to connect with your Stripe account.

Once the account is connected it should show "Online" in green on Woosignal which means it was successfully connected. The next step is to visit Stripe and get your Publishable key. If you're not sure how to get this follow this guide, next copy your Publishable key and open the LabelCore file in Xcode. Inside this file contains the following variable we need to update.

let stripePublishable:String! = "paste publishable key here"

Note: To change the enviroment to live you will need to turn off "test mode" in Woosignal and update the publishable key in the app to the live key

PayPal


Inside "LabelCore" contains the configuration values for PayPal.

let paypalClientID = "your paypal client id"
let paypalSecert = "your paypal secret"

IMPORTANT! Change the client id to alter environment (live/sandbox)

Credits


  • Icon's made by Freepik from www.flaticon.com