This integration will allow your reader users to make the purchase from your page in Wordpress, and then they can access the content in the store with publica.la

Before you begin, you will need to have your WordPress site with the WooCommerce plugin installed.

a. Download the plugin from our repository . Click here to download the .zip file to your computer.

b. Install the plugin in Wordpress . Enter Wordpress and go to the administration panel.

Go to Plugins > Add New. Drag the file or browse to it on your computer and click "Install Now," then follow the Wordpress instructions.

c. Go to Woocommerce > Settings > Accounts & Privacy
​

- Checkout as a guest : Uncheck the option 'Allow customers to order without having an account' and check the option 'Allow customers to access an existing account at checkout'.

- Account creation: Check the option 'Allow customers to create an account during the purchase process'.

d. Enable the plugin
​
​

b. Complete the following fields:
​
​- Domain (domain): Here you must enter the URL of the store to integrate, for example: 'exempligratia.publica.la'.
​
​- API Token: It is the token to access the publica.la API, generated in Control Panel > Settings > Integrations:

If you have not yet generated an API Token, enter the store with your administrator user and go to Control Panel > Settings > Integrations , then click on Generate new token. Here more information.

You must enter only the key, for example: api-306d9089-e7e7-4163-8fe4-ffd64926c16g

- JWT Secret Token: It is a shared key that is used to sign the tokens. We recommend using a version 4 UUID that you can generate from this link .

For example: ac4fbd39-3c1f-4942-a589-48e3bcffdb8e

- JWT Issuer: Identifies the issuer of the token. Here you must place the name of your store, for example "exempli".

- JWT Error Redirect URL: It is a URL for the redirection of the users in case of failure in the Login or in the Registry. For example: https://woocommerce-330087-193564.cloudwaysapps.com/auth-token-error

Write to us at [email protected] to tell us the JWT Secret Token, JWT Issuer and JWT Error Redirect URL . From our side we must register this data for the integration to work.

Posts uploaded to the publica.la store must have the ISBN or External id field filled in to be able to link the products in WooCommerce, setting the same external_id on both platforms

If the publication does not have an ISBN you can enter a random External id, for example: 001-23456.

​a. Create a product in Wordpress . Go to Products > Add new and complete the publication data: Name, description, image, etc.

b. Link the Wordpress product to the store listing with publica.la . In the "Product Details" section, click the dropdown menu and choose Publica.la (Single) for a publication, or Publica.la (Subscription) for a subscription plan.

- Publica.la (Single) : In the External ID field , place the ISBN or External id with which the publication is uploaded in the publica.la store, and in the External Product Type field choose if the product is an eBook or an Audiobook:

- Publica.la (Subscription) : In the case of a subscription, you must have previously uploaded the individual products in Wordpress and created the subscription plan in the publica.la store. Then you can enter the data in the fields External ID (enter the id of the plan in publica.la * ) and Products (enter each product that will have the plan, you can place the first 3 letters of the product title and the system will show the options the products available)

(*) To know the id of the publica.la plan, enter the store and go to Control Panel > Plans, position yourself on the plan you created and click on the drop-down menu

. Select " Copy Link ".

Paste the URL into any text editor or a blank document. The plan id is the number that appears after the store url: store-url/subscribe/ plan-id ?........

For example: https://exempligratia.publica.la/subscribe/ 6636 ?signature=9ca368c02a12bd1d7781bde402e5ede0a4fc2f23933781a2dd0be641755429d1

👉 In this case, the plan id is 6636 .

​c. Sets the price of the product . In the product data section, choose the "General" option and enter the price of the product.

d. Finally click Publish .

Ready! You are done configuring the integration.
​
​

We recommend you make a test purchase to validate that it has been made correctly.

We hope this tutorial has been easy for you. If you have questions, write to us at [email protected] .

This integration will allow your reader users to make the purchase from your page in Wordpress, and then they can access the content in the store with publica.la

Before you begin, you will need to have your WordPress site with the WooCommerce plugin installed.

a. Download the plugin from our repository . Click here to download the .zip file to your computer.

b. Install the plugin in Wordpress . Enter Wordpress and go to the administration panel.

Go to Plugins > Add New. Drag the file or browse to it on your computer and click "Install Now," then follow the Wordpress instructions.

c. Go to Woocommerce > Settings > Accounts & Privacy
​

- Checkout as a guest : Uncheck the option 'Allow customers to order without having an account' and check the option 'Allow customers to access an existing account at checkout'.

- Account creation: Check the option 'Allow customers to create an account during the purchase process'.

d. Enable the plugin
​
​

b. Complete the following fields:
​
​- Domain (domain): Here you must enter the URL of the store to integrate, for example: 'exempligratia.publica.la'.
​
​- API Token: It is the token to access the publica.la API, generated in Control Panel > Settings > Integrations:

If you have not yet generated an API Token, enter the store with your administrator user and go to Control Panel > Settings > Integrations , then click on Generate new token. Here more information.

You must enter only the key, for example: api-306d9089-e7e7-4163-8fe4-ffd64926c16g

- JWT Secret Token: It is a shared key that is used to sign the tokens. We recommend using a version 4 UUID that you can generate from this link .

For example: ac4fbd39-3c1f-4942-a589-48e3bcffdb8e

- JWT Issuer: Identifies the issuer of the token. Here you must place the name of your store, for example "exempli".

- JWT Error Redirect URL: It is a URL for the redirection of the users in case of failure in the Login or in the Registry. For example: https://woocommerce-330087-193564.cloudwaysapps.com/auth-token-error

Write to us at [email protected] to tell us the JWT Secret Token, JWT Issuer and JWT Error Redirect URL. From our side we must register this data for the integration to work.

Posts uploaded to the publica.la store must have the ISBN or External id field filled in to be able to link the products in WooCommerce, setting the same external_id on both platforms

If the publication does not have an ISBN you can enter a random External id, for example: 001-23456.

​a. Create a product in Wordpress . Go to Products > Add new and complete the publication data: Name, description, image, etc.

b. Link the Wordpress product to the store listing with publica.la . In the "Product Details" section, click the dropdown menu and choose Publica.la (Single) for a publication, or Publica.la (Subscription) for a subscription plan.

- Publica.la (Single) : In the External ID field , place the ISBN or External id with which the publication is uploaded in the publica.la store, and in the External Product Type field choose if the product is an eBook or an Audiobook:

- Publica.la (Subscription) : In the case of a subscription, you must have previously uploaded the individual products in Wordpress and created the subscription plan in the publica.la store. Then you can enter the data in the fields External ID (enter the id of the plan in publica.la * ) and Products (enter each product that will have the plan, you can place the first 3 letters of the product title and the system will show the options the products available)

(*) To know the id of the publica.la plan, enter the store and go to Control Panel > Plans, position yourself on the plan you created and click on the drop-down menu

. Select " Copy Link ".

Paste the URL into any text editor or a blank document. The plan id is the number that appears after the store url: store-url/subscribe/ plan-id ?........

For example: https://exempligratia.publica.la/subscribe/ 6636 ?signature=9ca368c02a12bd1d7781bde402e5ede0a4fc2f23933781a2dd0be641755429d1

👉 In this case, the plan id is 6636 .

​c. Sets the price of the product . In the product data section, choose the "General" option and enter the price of the product.

d. Finally click Publish .

Ready! You are done configuring the integration.
​
​

We recommend you make a test purchase to validate that it has been made correctly.

We hope this tutorial has been easy for you. If you have questions, write to us at [email protected] .