HOMEPAGE

What is this for?

With HOMEPAGE you get a public website for your tenant at /homepage.

You can use it, for example, to:

• present your offering
• show services / products as tiles (setups)
• offer an inquiry form (prospects fill it out)

What's special: an inquiry can be saved automatically in the system, so you can continue working on it internally right away.

---

What happens when an inquiry is submitted?

When someone submits the form on /homepage, the following happens (depending on the enabled plugins):

• A tenant (residential) is created or reused via the email address.
• A contract is created from the inquiry (using the chosen setup as a template).
• Optional:
• If KANBAN is enabled, the contract lands in the "Inquiries" column.
• If MAIL is enabled, the mail event NEW_INQUIRY is triggered, and a confirmation/notification email can be sent.

This way, a website inquiry directly becomes an editable case in Allesda.

Public page

• GET /homepage – is publicly visible (no login required) and shows your texts, contact info, and setups/tiles.
• POST /homepage – receives the submitted inquiry form.

---

Step by step: maintain content

1) Change basic texts and contact info

1. Open Admin → Homepage (/settings/admin/homepage).
2. Adjust:

• Headline / subtitle
• Main color / look
• Contact details (email, phone, address)
• Opening hours
• Description texts / footer

3. Save.

2) Maintain tiles / setups (offerings)

Setups are the tiles available for selection on the public homepage. They also serve as a template: whoever picks a tile and submits the inquiry form automatically receives a contract with the stored content.

1. Open Admin → Homepage Setups (/settings/admin/homepage/setups).
2. Click "New" and fill in:

• Name (shown on the tile)
• Description
• Content / items (what's included in the booking)
• Number of people
• Optional: upload an image

3. Enable visibility (otherwise the tile won't appear publicly).
4. Set the display order so important offerings are at the top.
5. Save.

To edit existing tiles, go to Admin → Homepage Setups → [tile] → Edit.

3) Process inquiries

Incoming inquiries appear as contracts in the contract list (see VERTRAG) or as cards in the Kanban board (see KANBAN).

---

Frequently asked questions / problems

"The homepage isn't reachable"

• Check whether the HOMEPAGE plugin is enabled for the tenant.
• For your own domain: are DNS / subdomain set up correctly?

"Inquiries aren't created as contracts"

• The VERTRAG plugin must be enabled.
• The MIETER plugin must be enabled (a tenant is required).
• The setup must have a sensible template attached.

"No email arrives on inquiry"

• MAIL must be enabled.
• A mail rule for the event NEW_INQUIRY must exist.
• Check the mail queue in the mail admin (/settings/admin/mail/queue).

"Tile isn't visible"

• Is visibility enabled? Is the display order value set?
• The page may be cached — reload the browser.

---

Technical URLs (quick reference)

Public:

• GET /homepage – Public page
• POST /homepage – Submit inquiry

Admin (/settings/admin/homepage):

• GET /settings/admin/homepage – Texts / contact / look
• POST /settings/admin/homepage – Save texts
• GET /settings/admin/homepage/setups – Tile list
• POST /settings/admin/homepage/setups – Create tile
• GET /settings/admin/homepage/setups/{id}/edit – Edit tile
• POST /settings/admin/homepage/setups/{id}/edit – Save tile
• POST /settings/admin/homepage/setups/{id}/delete – Delete tile

Notes

• The public homepage is only available when the plugin is enabled.
• Inquiries automatically generate data across multiple plugins (tenant, contract, mail). Keep these plugins up to date.
• The homepage described here is the tenant homepage. The global Allesda landing page with example tiles lives in the app-admin area (/app-admin/homepage-tiles) and is a separate function for operators.