Versions Compared

Old Version 6

changes.mady.by.user Unknown User ([email protected])

Saved on

compared with

New Version 7

changes.mady.by.user Unknown User ([email protected])

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Lomakkeet sijaitsevat päätason "'forms" ' -taulukon listan sisällä. Oletuksena tämä sisältää ainoastaan yleisen palautelomakkeen (FeedbackSite).

"'fields" ' asetus (joka sisältää lomakkeen kentät) yliajetaan kokonaisuudessaan, muut kentät yksitellen. Eli jos haluat muokata yleisen palautelomakkeen kenttiä, kopioi "'fields" ' alkuperäisestä ja tee muutokset siihen. Muiden asetusten kanssa riittää kun kopioi yksittäisen yliajettavan asetuksen paikalliseen tiedostoon.

Note

Hallintaliittymä antaa tallennuksen yhteydessä virheilmoituksen mikäli asetustiedosto ei ole YAMl-formaatin mukainen. Yleinen virhe liittyy rivin sisennykseen, milloin virheilmoituksessa mainitaan "Indentation problem at line ".

Lomakkeen yleiset asetukset

AsetusSelitysMahdolliset arvot
enabledOnko lomake käytössä?
  • true
  • false
titleLomakkeen otsikkoKäännösavain
onlyForLoggedUsersNäytetäänkö lomake ainoastaan kirjautuneille käyttäjille?
  • true
  • false
emailSubject

Lomakkeen tallennuksen yhteydessä lähetettävän sähköpostiviestin otsikko.

Otsikkoon voi lisätä mukaan lomakekentän arvon. Esimerkiksi jos lomakkeella on alasvetovalikko (nimellä "toimipiste"), voi valikon arvon lisätä mukaan viestin otsikkoon näin:

emailSubject: Hankintaehdotus - %%toimipiste%%

Käännösavain
recipient

Lomakkeen vastaanottajan nimi ja sähköpostiosoite.

Code Block
recipient
  name: nimi
  email: osoite

Mikäli 'recipient' ei ole määritely, käytetään näkymän yleistä palauteosoitetta (Yleiset asetukset > Näkymän ylläpidon sähköpostiosoite).

Lomakkeelle voi määritellä useamman vastaaanottajan, asettamalla recipientin listaksi:

Code Block
recipient:
  - name: nimi-1
    email: osoite-1
  - name: nimi-2
    email: osoite-2


ks. esimerkit
sendMethod

Lähetetäänkö lomakkeen vastaukset sähköpostilla (email) vai tallennetaanko vastaukset tietokantaan (database)?

Oletuksena lomakkeen kautta kerätyt palautteet lähetetään määriteltyyn sähköpostiosoitteeseen (ks. 'recipient'). Mikäli palautteita ei tietoturvasyistä johtuen voida lähettää sähköpostin välityksellä, voidaan palautteet tallentaa tietokantaan.

Tallennettujen palautteiden käsittely tapahtuu hallintaliittymän Lomakkeet-osiossa. Osiossa listataan tuotantonäkymien kautta lähetetyt palautteet. Tietokantaan tallennusta ei siis voi kokeilla testipalvelimella.

  • email
  • database
hideSenderInfoKysytäänkö lomakkeella lähettäjän yhteystietoja (nimi ja sähköposti)? Oletuksena kysytään.
  • true
  • false
senderInfoRequiredEdellytetäänkö lomakkeen lähettäjän syöttävän yhteystietonsa?
  • true
  • false
senderInfoHelpLähettäjän yhteystietojen ohjeteksti.Käännösavain
responseLomakkeen lähetyksen jälkeen näytettävä viesti.Käännösavain
help

Lomakkeen ohjetekstit, näytetään lomakkeen alussa ('pre') ja/tai lopussa ('post). Käännös voi sisältää HTML-muotoiluja.

Code Block
help:
  pre: feedback_help_pre
  post: feedback_help_post


Käännösavain
fieldsLomakkeen kentätLista

Lomakkeen kenttien asetukset

AsetusSelitysMahdolliset arvot
nameKentän nimi
typeKentän tyyppi.
  • text (tekstikenttä)
  • textarea (tekstialue)
  • email (sähköpostikenttä)
  • url (URL-kenttä)
  • select (valikko)
  • radio (valintanappi)
  • checkbox (valintaruutu)
labelKentän otsikkoKäännösavain
requiredOnko kenttä pakollinen? Oletuksena ei ole.
  • true
helpElementin ohjetekstiKäännösavain
settings

Lista HTML-elementin arvoista.

Esimerkki: listätään elementille omat CSS-luokat:

Code Block
settings:
  - [class, "css-luokka1 css-luokka2"]


Lista
options

Elementin valinnat (vain kun type on 'select', 'radio' tai 'checkbox').

Code Block
options:
  - valinta-1
  - valinta-2
  - valinta-3


Lista käännösavaimia.
optionGroups

Elementin valinnat eroteltuna omiin ryhmiinsä (vain kun type on 'select'). 'label' määrittää ryhmän otsikon (käännösavain).

Code Block
optionGroups:
  - label: otsikko-1
    options:
     - valinta-1a
     - valinta-1b
  - label: otsikko-2
    options:
     - valinta 2a
     - valinta 2b


Lista.
placeholder

Select-valikon ensimmäinen elementti (vain kun type on 'select').

Jos 'placeholder' on määritelty ja elementti on pakollinen ('required = true'), lomakkeen voi lähettää vain jos on valinnut valikosta jonkin muun kuin oletuksena näytettävän ensimmäisen elementin.

Esimerkki: select-valikko, jonka ensimmäinen elementti on "Valitse toimipiste" ja tämän jälkeen valittavissa olevat toimipisteet:

Code Block
type: select
required: true
placeholder: Valitse toimipiste
options:
  - toimipiste-1
  - toimipiste-2


Käännösavain


Esimerkki: poistetaan palautelomakkeelta Aihe-valikko ja lisätään Toimipiste-valikko. 

...

/Feedback/Form/<lomakkeen nimi>

 

...

Oletuksena lomakkeen kautta kerätyt palautteet lähetetään määriteltyyn sähköpostiosoitteeseen. Mikäli palautteita ei tietoturvasyistä johtuen voida lähettää sähköpostin välityksellä, voidaan palautteet tallentaa tietokantaan. Tämä tapahtuu (lomakekohtaisesti) asetuksella "sendMethod = database".

...