Get started​

This guide walks you through integrating a theme app extension into a theme, from creation to publication.

Prerequisites​

• Create a SHOPLINE partner account.

• Create an app in the Partner Portal.

• Create a development store in the Partner Portal.

• Install your app in the development store.

• Install the SHOPLINE CLI.

• Install an OS 3.0 version theme for your development store.

Step 1: Create a theme app extension locally​

Use the SHOPLINE CLI to locally create a directory for your theme app extension.

1. Open a terminal and navigate to an empty directory.

cd <my-directory>

2. Log in to your development store.

sl login --store <MY_STORE>.myshopline.com

3. Create a theme app extension.

sl extension create

4. Follow the prompts to select the appropriate options. After completing the selections, you will see a folder named theme-app-extension in your directory.

   

Step 2: Push the theme app extension​

1. Navigate to the theme app extension directory.

cd theme-app-extension

2. Push the theme app extension.

sl extension push

3. Follow the prompts and choose the appropriate options.

   

4. Click the link to visit the SHOPLINE Partner Portal. Find the theme app extension and click the toggle button as shown in the following image to change the app extension to a draft version.

   

Step 3: Test your changes​

1. In your SHOPLINE Admin, go to Online Store, select the OS 3.0 version theme, and click the Design button to enter the theme editor.

2. In the theme editor, click Add component, select the Apps tab, and add your app to the theme.

3. Save the changes to the theme.

4. Verify that the theme app extension functions as expected.

Step 4: Publish the theme app extension​

1. Push the theme app extension to the SHOPLINE Partner Portal.

sl extension push

2. After a successful push, the system will automatically generate and display a link in the terminal, which directs to the current app version page in the Partner Portal.

3. Click the link to enter the app version. Then click Create new version.

4. Close and disable the preview of the draft version extension.

   

5. Click the back button, find App version, and click to enter. Then create and publish the extension version here.