Zerra logo

ZerraLivin Documentation Campaign

Banner

Create promotional banners that link to a URL or straight to a voucher, and control their order and popup behavior.

  • view
  • get
  • create
  • update
  • delete

What it’s for

A Banner is a promotional image shown to residents — either a plain link banner, or one that opens a specific voucher directly.

Where to find it

Sidebar → CampaignBanner, at /admin/campaign/banner.

Who can use it

  • See the menu item and open the page — needs view.
  • See the banner list — needs get.
  • Create, edit, delete — each needs its own permission.

On this screen

A table of banners with create, edit, and delete actions.

How to…

Create a banner

  1. Click create.
  2. Enter a title and upload the banner image — both required.
  3. Choose its type: Link or Voucher.
  4. If Link, enter a valid URL. If Voucher, pick the voucher it opens.
  5. Set a sort order (a whole number, 0 or higher) — this controls display order among other banners.
  6. Choose whether it shows as a popup, and whether it’s active.
  7. Save.

Edit or delete a banner

  1. Open the edit or delete action on its row.
  2. For edit, change any field. For delete, confirm.

Field reference

FieldRequiredNotes
Title, imageYes
TypeYesLink or Voucher
LinkIf type is LinkMust be a valid URL
VoucherIf type is Voucher
Sort orderYesWhole number, 0 or higher — lower shows first
Popup, ActiveYes

Rules & statuses

Which field is required — Link or Voucher — depends entirely on which type you picked. Pick the type first, then fill in the matching field.

  • Voucher — what a voucher-type banner opens.