Placing the addon settings into Shoptet administration

If your addon includes user settings, you can place the settings page directly in Shoptet administration, as an iframe. The link to addon settings will then be displayed directly in the Shoptet administration menu.

What to do

URL pages

IFrame and cookies in Safari

Some versions of Safari refuse to set up a cookie for a page in iframe, if the user does not have a page in the history of the pages visited.
The solution is to redirect the user’s browser before displaying the iframe to a page on the same domain as iframe, return the user back, and then display iframe.

Procedure:

  1. Create any URL on the same domain as the addon settings is running, with the following content:
<!DOCTYPE html>
<html>
<head>
    <title></title>
</head>
<body>
<script>
    document.cookie = 'safari_cookie_fix=fixed; secure; path=/';
    const urlParams = new URLSearchParams(window.location.search);
    const backUrl = urlParams.get('backUrl');
    if (backUrl !== null) {
        window.location.replace(decodeURIComponent(backUrl));
    }
</script>
</body>
</html>

JavaScript adds the URL to the browser history and redirects it to the URL received in the GET parameter backUrl.

  1. Enter the URL you created into the addon administration settings.

Inserting JavaScript into a page

Set up Page stylising

body {
    height:auto
}

Contents of the page

What the page shall contain

What the page should not include

The page serves only to set up the addon itself, directly in the administration of the e-shop. Therefore it is prohibited to use it for other purposes. This means:

Test the page display in administration

TIP: If you want to convert the administration view of an existing addon, it is recommended that you create a test addon with identical settings to test and debug the administration view.