Voit näyttää Spotillan julkisen palvelupyyntölomakkeen oman verkkosivustosi sisällä. Vierailija täyttää lomakkeen sivullasi, ja lähetetty palvelupyyntö tallentuu Spotillaan. Upotus määritetään Spotillan selainkäyttöliittymässä.

Oikeudet ja lomakkeen valmistelu

Tarvitset oikeuden muokata palvelupyyntöjen asetuksia sekä oikeuden lisätä HTML-upotus kohdeverkkosivulle. Spotillan pääkäyttäjällä on palvelupyyntöasetusten hallintaoikeus. Verkkosivun muokkausoikeudet saat sivustosi ylläpitäjältä.

Avaa Spotillan sivuvalikosta Palvelupyynnöt → Palvelupyyntöjen asetukset. Tarkista Asetukset-välilehdellä, että Palvelupyyntöominaisuus käytössä on valittu ja Poista julkinen oletuslomake käytöstä on pois päältä. Tallenna mahdolliset muutokset painikkeella Päivitä palvelupyyntöasetus.

Valmis upotuskoodi avaa suomenkielisen oletuslomakkeen. Sen vaihtoehtoina näkyvät vain aktiiviset palvelupyyntölajit, jotka on määritetty julkisiksi. Tarkista Palvelupyyntölajit-välilehdellä lajien Käytössä julkisella lomakkeella -asetus ja varmista lomakkeelta, että ainakin yksi tarkoitettu laji on valittavissa.

Julkiset lomakkeet -välilehdellä erikseen luodun lomakkeen laji-, kansio- ja salasana-asetukset eivät siirry oletuslomakkeeseen. Upotuskoodi ei automaattisesti osoita tällaiseen lomakkeeseen. Katso erillisten lomakkeiden määrittäminen ohjeesta Julkisen palvelupyyntölomakkeen asetukset.

Salli sivusto ja lisää upotuskoodi

  1. Valitse palvelupyyntöjen asetuksissa Upotuskohteet-välilehti ja paina Lisää uusi sallittu kohde.
  2. Täytä Kohdesivun osoite sen verkkosivuston osoitteella, jolla lomake näytetään. Käytä sivuston alkuperäosoitetta, esimerkiksi https://www.esimerkki.fi: mukaan kuuluvat protokolla, verkkotunnus ja mahdollinen erillinen portti. Yksittäisen sivun polku ei rajaa upotuslupaa vain kyseiseen sivuun. Huomioi myös mahdollinen ohjaus toiselle verkkotunnukselle.
  3. Tallenna painamalla avautuneessa ikkunassa Lisää uusi sallittu kohde. Uusi kohde ilmestyy välilehden listaan.
  4. Paina kohteen Koodi upottamista varten -kentän vieressä Kopioi koodi.
  5. Avaa kohdeverkkosivun muokkaus ja liitä koodi sivustosi HTML- tai upotusalueeseen. Julkaise sivu sivustosi oman käytännön mukaisesti.

Koodi näyttää lomakkeen iframe-kehyksessä, jonka oletusleveys on 500 ja korkeus 700 pikseliä. Voit sovittaa kehyksen mitat sivustosi ulkoasuun. Säilytä lomakkeen osoite ja siihen sisältyvä token-tunniste: Spotilla käyttää tunnistetta kyseisen upotuskohteen luvan löytämiseen. Tunniste kulkee myös lomakkeen lähetyksen ja onnistumissivun mukana.

Upotuskohde sallii lomakkeen näyttämisen määritetyn sivuston kehyksessä. Se ei ota suljettua lomaketta käyttöön, muuta palvelupyyntölajeja eikä anna vierailijalle oikeutta käsitellä Spotillan palvelupyyntöjä. Oletuslomake on käytettävissä myös suoraan sen osoitteesta; upotuslupa ei rajaa pyynnön lähettämistä vain omalle verkkosivullesi.

Varmista toiminta julkaistulla sivulla

Avaa julkaistu verkkosivu ilman Spotilla-kirjautumista. Tarkista, että lomake näkyy, tarkoitetut ilmoituslajit ovat valittavissa ja kaikki kentät sekä lähetyspainike ovat käytettävissä myös puhelimen näytöllä. Pelkkä koodin tallentuminen sivuston editoriin ei vahvista upotuksen toimivuutta.

Lähetä selvästi testiksi nimetty palvelupyyntö ohjeen Julkisen palvelupyynnön lähettäminen mukaisesti. Onnistumissivun ilmoitus Palvelupyyntö lähetettiin onnistuneesti. vahvistaa lähetyksen. Tarkista, että myös onnistumissivu näkyy kehyksessä.

Koepyyntö on oikea Spotillaan tallennettu palvelupyyntö. Pyydä henkilöä, jolla on oikeus nähdä kyseisen lajin pyynnöt, tarkistamaan se Spotillan Palvelupyynnöt-listasta. Varmista otsikko, ilmoituslaji ja mahdollinen Spotti. Tarvittaessa käytä ohjetta Palvelupyyntöjen haku ja vastuuttaminen. Upotus ei muuta käsittelijöiden käyttöoikeuksia.

Jos lomake ei näy, tarkista tallennettu kohdesivun osoite, julkaistun sivun todellinen verkkotunnus ja upotuskoodin tunniste. Tarkista myös oletuslomakkeen käytössäolo. Jos lomake avautuu suoraan mutta ei verkkosivun sisällä, pyydä sivuston ylläpitäjää tarkistamaan, että sivusto sallii Spotillan iframe-upotuksen ja säilyttää koodin julkaistaessa.

Muuta osoitetta tai poista upotuslupa

Muuta Upotuskohteet-välilehdellä kyseisen kohteen Kohdesivun osoite ja paina sen vieressä Päivitä osoite. Tunniste säilyy samana, joten olemassa olevan koodin voi käyttää uudessa kohdesivustossa. Tarkista toiminta uudelleen julkaistulla sivulla. Vanha sivusto menettää tähän kohteeseen perustuvan upotusluvan, ellei sille ole muuta voimassa olevaa lupaa.

Poista lupa painamalla kohteen oikeassa reunassa olevaa roskakorikuvaketta ja vahvistamalla poisto. Poistettuun kohteeseen liittyvä tunniste ei enää anna upotuslupaa seuraavilla latauksilla. Poisto ei poista lomaketta, palvelupyyntölajeja tai jo lähetettyjä palvelupyyntöjä eikä sulje oletuslomakkeen suoraa osoitetta.

Poista tarvittaessa myös upotuskoodi omalta verkkosivultasi. Jos lisäät kohteen myöhemmin uudelleen, se saa uuden tunnisteen: kopioi uusi koodi verkkosivulle ja testaa upotus uudelleen.