Installation
Installation is done in the classic way as for all other addons for Shoptet. Just click on the "Order and Install" button on the addon page https://doplnky.shoptet.cz/miguel-e-knihy.
Pairing the e-shop
After installing, you will find the pairing code on the addon's settings page in the Shoptet administration, and it also arrives by email. Shoptet asks you to sign in to the administration before the page shows the code. The link next to the code and the link in the email open the pairing page with the code filled in.
On the Pair your e-shop page, check the Pairing code and press Continue.
The pairing code and the Continue button
If you are already signed in, the pairing form opens straight away. Otherwise Miguel shows the e-shop it found and asks whether you already have a Servantes account: choose Create an account or Sign in.
The e-shop found: create an account or sign in
A new account
On the New organization registration page, fill in a password and check the prefilled details. Then:
- tick I accept the terms of use,
- press Register.
New organization registration
After registering, the Dashboard opens and you will find the e-shop in Sales > E-shops.
A customer who already uses Miguel
Sign in and attach the e-shop to an organization you already have in Miguel. You cannot create a new organization here.
- Choose the organization in Pair with organization. If you have only one, it is already selected.
- Tick I accept the terms of use.
- Press Pair this organization with the selected one.
Pairing with an organization that already uses Miguel
If you have a Servantes account but none of your organizations uses Miguel yet, you choose between Add new organization and Existing organization. The terms of use must be accepted here too, and you confirm the pairing with Add this organization to your account or Pair this organization with the selected one.
After pairing
After pairing you land on Sales > E-shops. The Pair an e-shop button opens the same page as the link with the code; use it for a further e-shop.
The e-shop shows under the organization you paired it with. If that is not the one you are working in, switch to it in the top bar.
Sales > E-shops and the Pair an e-shop button
Creating an e-book or audiobook
In Miguel, create the book and upload its files as described in Usage > Books. The book's title does not have to match the product name in Shoptet. This name will be used as the name of the file that will be delivered to customers.
On the other hand, the Code field of the book's format MUST match the product code in Shoptet, which can be found at: Shoptet > products > prices.
In the image shown here, you can see it in the code column:
Product code identification in Shoptet
If you don't have e-books or audiobooks created in Shoptet yet, you can create them as a separate product or you can use the "Product with variants". You can find it in the "Price list" tab of the specific product.
Creating an e-book category ("product with variants")
Over time, it is possible to change the e-books if it is necessary to upload a new version or, for example, to use the principle of pre-sales, see Usage > Books > Version Control.
(note: During pre-sales of e-books or audiobooks, only part of the e-book is released at a special price before the official release, e.g. 30% of the book with 30% discount. Then, on the agreed date, you upload the full version over the current version of the file and the customer downloads the e-book again, but in its entirety.)
Audiobooks
Miguel also allows you to send out audiobooks. The zipped mp3s leave from a secure link, so there is no mass distribution of a public link, which could result in illegal downloads.
Add the audiobook to the same book as another format. The e-book and the audiobook each have their own Code field, so you can pair them with Shoptet as two variants of the same book. Each product variant has its own product number in Shoptet (e.g. 146/E-K and 146/AK).
Social DRM settings (for e-books)
In the left menu, click Organization (in the Settings section) and then the DRM template tab.
Settings > Organization > DRM template
To embed social DRM in books, you need to set it up first:
- Choose Insert social DRM in books generated from EPUB. A short guide and a box with the template appear.
- Press Use the standard template, which fills in the default look of the social DRM page. If you know XHTML, you can customize it to suit your needs.
- Press Save changes.
Setting up social DRM
It is also possible to set up your own SMTP server for sending emails, in Settings > Organization > Emails. For more information, see Usage > Settings > Emails > SMTP.
If you don't want to change the settings, you can keep the default email. The customer will receive an email from Miguel, and if they reply, the reply will be delivered to your email address.
Setting up order status
The last step is to set up order statuses. It is necessary to specify what order statuses are to be processed and how they are supposed to switch correctly at Shoptet. In the left menu, click E-shops (in the Sales section) and then the Shoptet tab. The tab appears once the e-shop is paired.
Sales > E-shops > Shoptet
You can create custom order statuses in Shoptet. The following picture can serve as a guide.
Explanation of what each box does
Box Process orders in states:
In general, Miguel is mainly interested in orders that need to be processed and delivered to the customer - i.e. usually
in Pending and Completed status. However, it is entirely up to you what you name each status in Shoptet. For
example, you can have an E-book or Audiobook status.
Box contains only Miguel books:
If all the items in the order are delivered by Miguel, it takes them to the final status and the order is therefore Completed.
Box contains Miguel books and other products:
Because Miguel can only deliver products stored inside itself, it can only handle a part of an order containing, for
example, an e-book and a printed book. In this case, the e-book is delivered to the customer and the printed book has to
be sent physically. In this case, it is a good idea to set the status to Pending.
Box contains no Miguel products:
You can't ask Miguel to monitor and guarantee products it knows nothing about. Therefore, we recommend to use the Don't change setting.
Box under unsuccessful processing contains only Miguel books:
It's a good idea to create an order error alert and create a Miguel ERROR status in Shoptet, which will draw your
attention to the processing of the order.
Box under unsuccessful processing contains Miguel books and other products:
Here, it is a good idea to create an alert for any error in order processing and create a Miguel ERROR status in
Shoptet (you can call it anything), which will draw your attention to the processing of the order even if Miguel has
evaluated the Error only for the products for which it is responsible, i.e. – they are stored inside Miguel.
Example of order status settings
The first order
You're done. As soon as a customer buys, the order appears in Sales > Orders, within 10 minutes at the latest.
Sales > Orders
If you have any questions, please do not hesitate to contact our support team: podpora@servantes.cz.