Skip to main content

Settings

Social DRM​

You must set up a template to automatically insert social DRM. You can use our default one which is sufficient for most cases. If necessary, you can customize the template as you need, it is XHTML code that is inserted as a page in the book.

Inserting can be switched off or on at any time. It is currently applied to all books at the same time.

Template for social DRM​

User information is inserted when the book is generated. The insertion points are marked with special marks:

  • {{USER_NAME}} - full name of the user
  • {{USER_EMAIL}} - email of the user
  • {{USER_ADDRESS}} - address of the user
  • {{PURCHASE_DATE}} - the date of purchase

In the case of EPUB, these marks can be inserted anywhere in the book (the whole book is browsed this way).

Both supported formats have their different options, see the options for EPUB and PDF. A separate template can be set up for each format, since each format works completely differently.

Emails​

There is no need to set up anything to send emails with links to download e-books. Miguel will use the default template and a custom email address (miguel@servantes.cz). However, we recommend setting up both so that users are not confused and everything looks as if sent from your e-shop.

Template​

A custom template can be set up for an email that is sent to the customer with links to download the e-books.

It is an HTML code that is sent to the customer when the order is completed. We use the handlebars templating language to insert dynamic data such as book titles, download links and more.

For inserting data you can use the following:

  • Information about your e-shop:
    • {{eshop.name}} – e-shop name
    • {{eshop.url}} – URL to the main page of the e-shop
    • {{eshop.contactEmail}} – contact
  • Information about the order
    • {{order.code}} – order code
    • {{order.downloadPage.url}} - link to the download page for this order
  • Books
    • {{books}} – list of the books (it is necessary to use {{#each books}} and {{/each}} for browsing all the books in the order)
      • {{title}} – title of the book
      • {{formats}} – list of available formats
        • {{name}} – format name
        • {{url}} – URL to download the format

If you are unsure, try filling out a sample and contact us for support if necessary (miguel@servantes.cz).

SMTP​

There are several items that need to be configured for your SMTP server to work properly. You can usually find out about these settings from your email provider.

  • Host: the domain on which the SMTP server is running
  • Port: the port number on which the STMP server is available
  • SSL: set yes if SSL is used, no if TSL or plain auth is used
  • Sender's name and address: type in the format Name of the e-shop <eshop@example.com>, for example, for Jan Melvil it would be Jan Melvil Publishing <eshop@melvil.cz>.
  • Hidden copy (BCC): Same as sender (set only if you need the emails to go somewhere else, for example to an accountant)
  • Reply-To: same as sender (set only if you need replies to go to a different address than the sender)
  • Username: most often this is the full email address
  • Password: login password (not displayed after saving for security reasons)

To verify, use the button Send a test email. If you get a test email when you use the button, everything is set up correctly.

Note: Miguel's main server runs in Germany, which can sometimes cause problems for some email providers. For example, WebGlobe does not support logging in from Germany by default and you have to manually add Germany in the email administration.

Gmail​

For Gmail, use this setting:

  • Host: smtp.gmail.com
  • Port: 465
  • SSL: Yes
  • Username: full email address
  • Password: your password (if you use two-factor authentication, create an application password using this guide from Google)

Unfortunately, Miguel does not yet support Google login, so you need to create an application password in the case of two-factor authentication.

Outlook​

For Outlook.com, use this setting:

  • Host: smtp.office365.com
  • Port: 587
  • SSL: No
  • Username: full email address
  • Password: your password

Full instructions can be found on the Microsoft website.

Seznam​

For Seznam, use this setting:

  • Host: smtp.seznam.cz
  • Port: 465
  • SSL: Yes
  • Username: full email address
  • Password: your password (if you are using two-factor authentication, create a password for email and CalDAV logs using this guide from Seznam)

The full instructions can be found on the Seznam website: https://napoveda.seznam.cz/en/email/imap-pop3-smtp/.