ManualReferenceApp-StoreAdmins
Images via Bunny
With the app Images via Bunny, Bunny resizes the pictures of the offers and the logos of the organizer profiles instead of the server.
Location: Settings > App-Store > card Images via Bunny from BunnyWay d.o.o. Visible to: super admins.
Group: Website > Image delivery, one provider. Provider: Bunny, delivery through Bunny’s CDN (content delivery network).
Catalogue, states and structure of an app are described in App-Store.
What the app does
| In the section What it does |
|---|
| “Delivers the pictures of the offers and the logos of the hosts through Bunny’s CDN: on the website, in the admin panel and in the API.” |
| “Keeps the marked part of a picture in view when cropping.” |
| “Serves WebP to browsers that support it.” |
| “Removes deleted pictures from the CDN as well, where an API key is entered.” |
| “Puts the pictures on a hostname of your own if you like, e.g. img.your-domain.org.” |
| “Without the app, the installation’s setting applies.” |
| In the section How to use it |
|---|
| “Nothing to do. The pictures look as before and load through Bunny’s CDN.” |
Card in the catalogue: “Resizes the pictures of the offers and the logos of the hosts at Bunny instead of on the server.”
Access
| Field | Content |
|---|---|
| Pull zone hostname | Required, at most 255 characters, a hostname with a top-level domain. Placeholder: bilder.b-cdn.net. Help text: “From bunny.net › CDN › Pull Zone. Bunny Optimizer, the Dynamic Image API and WebP must be switched on in the zone.” |
| API key | Optional, stored encrypted. Help text: “From bunny.net › Account › API. Only used to remove deleted pictures from the CDN; without it Bunny keeps them until they expire.” |
| Pull zone ID | Optional, digits only, at most 20 characters. Placeholder: 123456. Help text: “From bunny.net › CDN › Pull Zone, the number in the address. Only for a tenant's own hostname.” |
Own hostname
The setting Own hostname appears once API key and Pull zone ID are entered.
| Feature | Content |
|---|---|
| Own hostname | Optional, at most 253 characters, a hostname with a top-level domain. Placeholder: img.example.org. Help text: “Optional, e.g. img.your-domain.org. Where the domain is ours, its DNS record is added; otherwise the hostname needs a CNAME to Bunny's zone (see „Check“). Until it is set up, the pictures load by the installation's hostname.” |
| Not allowed | A hostname a website answers at: “A website answers at this hostname.” A domain at fepli that does not belong to the tenant: “The zone {zone} is not among this tenant's domains.” If this cannot be checked, nothing is saved: “Whether the domain is ours could not be checked just now. Please save again later.” |
| Setting up | After saving, fepli sets up the hostname and its certificate in the background. Until then, the pictures load by the installation's hostname. |
| Check | Own hostname gives the status: “The pictures load by {hostname}.”, “{hostname} is being set up. …” or “{hostname} could not be set up: … Save the hostname again to try once more.” CNAME in the DNS gives the target of the CNAME. |
| Changing or emptying | fepli takes the previous hostname out at Bunny, and a CNAME it added as well. |
Behaviour
| Feature | Content |
|---|---|
| Pull zone | One pull zone serves every tenant of an installation. A tenant may enter one of its own. |
| Set by the installation | The installation can set the hostname, the API key and the pull zone ID (BUNNY_OPTIMIZER_HOST, BUNNY_API_KEY and BUNNY_PULL_ZONE_ID, described in fepli developers). Fields that are set cannot be changed here. |
| Connected | Bunny resizes the pictures of the offers, the logos of the organizer profiles and the pictures of the page Files, on the website, in the admin panel and in the API. Bunny fetches each picture from the server. The address of a picture contains the tenant, the storage and the path of the file. |
| Cropping | If a picture has a marked part, it stays in view when cropping. Without a mark, the middle stays. |
| Delivery | The CDN serves WebP to browsers that support it. SVG files and attachments stay with Contao. |
| Deleted pictures | If someone deletes or moves a picture or a folder, fepli removes the copies from the CDN, provided an API key is entered. Without it, Bunny keeps them until they expire. |
| Disconnected | The installation’s setting for pictures applies. |
| Accessibility | The pictures of the offers and the logos can be retrieved at their path (/storage/<tenant>/<storage>/<path>), including pictures of the page Files that are not on an offer yet. |
Data protection
| Row | Content |
|---|---|
| Where to | EU |
| What | Requests for the pictures; the pictures themselves |
| Data category | IP address |
| Category of data subjects | Website visitors, Participant accounts, Organizers, Team |
| Legal basis | Legitimate interest, Art. 6(1)(f) GDPR |
| Note | “Bunny fetches each picture once from the server and delivers it from its locations. Bunny sees the IP addresses of visitors in doing so.” |