> For the complete documentation index, see [llms.txt](https://mstoreappdocs.gitbook.io/mstoreapp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mstoreappdocs.gitbook.io/mstoreapp/woocommerce-app-docs.md).

# Getting Started

## Getting started

Setup ionic environment - to know more about ionic environment setup see, ionic framework official document - [**https://ionicframework.com/docs/intro/installation/**](https://ionicframework.com/docs/)

Unzip downloaded files

Change your details in **app/config.xml**. Change id, name, description, author, email, href

```markup
<?xml version='1.0' encoding='utf-8'?>
<widget id="com.ionic.starter" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
    <name>WooCommerce</name>
    <description>An awesome WooCommerce app.</description>
    <author email="support@mstoreapp.com" href="http://mstoreapp.com/">Mstoreapp Team</author>
```

CD app

```
$ cd app
```

Add android and ios platform to your project

```
$ ionic cordova platform add android
```

```
$ ionic cordova platform add ios
```

## Wordpress **Plugin Installation**

To install plugin **mstoreapp-mobile-app** for WordPress follow these steps.

Install Redux Frameworks. If you  have not installed yet - <https://wordpress.org/plugins/redux-framework/>

1. In Wordpress admin panel. **`Plugins > Add New > Upload plugin > Choose file`** Chose downloaded **mstoreapp-mobile-app.zip** file and Install and activate

OR

1. Unzip downloaded **mstoreapp-mobile-app.zip** and Upload the **mstoreapp-mobile-app** folder to the **`wp-content/plugins/ directory`**.
2. Activate the plugin through the Plugins menu in WordPress.

## **WooCommerce API**

1. It's required to turn on the WordPress permalink on **`Settings > Permalinks`**
2. Visit **`WooCommerce > Settings > Advanced > REST API`** tab and tick the Enable REST API Checkbox
3. &#x20;Visit **`WooCommerce > Settings > Advanced > Legacy API`** tab and tick the Enable Legacy REST API Checkbox
4. Go to **`API WooCommerce > Settings > Advanced > REST API > Keys/Apps > Add Key`**

![](https://2532985797-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L9dfyK8qHyd3G-y0mZm%2F-LWK8Ea5yq9UlPnDL1nD%2F-LWK8_DyFlVRbil0Kia5%2FScreen%20Shot%202019-01-16%20at%2011.01.07%20AM.png?alt=media\&token=75466573-223a-488b-8dd5-798f08c417dc)

Select the user in user field and add a description. Choose level of access **Read/Write**. then select the button Generate API Key and WooCommerce will generate API keys for that user.

![](https://2532985797-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L9dfyK8qHyd3G-y0mZm%2F-LWK8Ea5yq9UlPnDL1nD%2F-LWK8uxsvFLOFI68wVKq%2FScreen%20Shot%202019-01-16%20at%2011.04.18%20AM.png?alt=media\&token=ccadf242-63af-437d-81ef-4e68d12b0f46)

Now you should see two new keys, These two keys are your Consumer Key and Consumer Secret

![](https://2532985797-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L9dfyK8qHyd3G-y0mZm%2F-LWK8Ea5yq9UlPnDL1nD%2F-LWK9AWIsKBY09Ifahsy%2FScreen%20Shot%202019-01-16%20at%2011.05.24%20AM.png?alt=media\&token=db37238f-5893-466c-9fe3-daac73e690f4)

Add url, api keys in **app/src/providers/service/config.ts** file.

For ionic 4 apps in **app/src/app/config.ts** file

```typescript
    url: any = 'URL_PLACEHOLDER';
    consumerKey: any = 'CONSUMER_KEY_PLACEHOLDER';
    consumerSecret: any = 'CONSUMER_SECRET_PLACEHOLDER';
```

Go to **`Wordpress > Mobile Options.`** Add **Banners Blocks, Category Blocks, Product Blocks and Settings**.

![](https://2532985797-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L9dfyK8qHyd3G-y0mZm%2F-LRAgrbZ6yuMr1vXoYKc%2F-LRAh1L78lpDLZz1V0lJ%2FScreen%20Shot%202018-11-13%20at%2011.41.17%20AM.png?alt=media\&token=c2e55c34-f226-43d4-9ded-8cfc7a7c7204)

####

### Now you can run your app.

```
$ ionic serve
```

```
$ ionic cordova build android
```

```
$ ionic cordova build ios
```

{% hint style="info" %}
Debug apk may take time to load on some android devices. you need to build --prod to load faster

```
ionic cordova build android --prod
```

```
ionic cordova build ios --prod
```

{% endhint %}

## If you have an issue read FAQ Or Feel free to contact me

<https://codecanyon.net/user/hakeemnala> Or send me a mail with details of the issue and your purchase code, URL, API, keys admin panel access <hakeem.nala@gmail.com>

{% hint style="success" %}
**IF YOU LIKE MY WORK DON’T FORGET TO RATE IT**
{% endhint %}

**THANK YOU!**