Prettylib-tuoteratkaisut - Wiki

PrettyLibServerin tiedostot protokollaneutraaleiksi

Mikäli PrettyLibServerissä käytetään salattua HTTPS-protokollaa ja normaalia http-protollaa sekaisin, tulee kaikki sivujen sisäiset viittaukset tyylitiedostoihin, kuviin ja scripteihin muuttaa joko "suhteellisiksi" tai protokollaneutraaleiksi.

Mikäli käytetään pelkästään salattua HTTPS-protokollaa tulee varmistaa, että kaikki ulkoiset viittaukset ovat myös https-viittauksia tai protokollaneutraaleja.

Mikä on suhteellinen viittaus?

Suhteelliseksi viittaukseksi tarkoitetaan esimerkiksi kuva-, scripti- tai tyylitiedostoa hakutuloksessa. Mikäli hakutuloksessa tai tyylitiedostossa viitataan kuvaan ja kuva sijaitsee samalla palvelimella samassa osoitteessa kuin hakupalvelu, tulee kuviin viitata esim: "/images/star16n.gif" eikä suoraan "http://palvelin.domain.dom/images/star16n.gif".

Sama pätee tyylitiedostoihin ja scripteihin.

Mikä on protokollaneutraali viittaus?

Protokollaneutraalilla tarkoitetaan viittausta kuva-, scripti- tai tyylitiedostoon, johon pätee jompi kumpi seuraavista:

  • Viittaus on suhteellinen
  • Viittaus EI sisällä http- tai https-alkua (linkit alkavat merkeillä "//")


Protokollaneutraali viittaus on esimerkiksi oheisen kaltainen:


Huomaa, ettei yllä olevassa linkissä ole http- tai https-alkua vaan se alkaa "//" merkeillä. Tämä tarkoittaa sitä, että selaimen pyytäessä hakulomaketta ja hakulomakkeen sisältäessä viittauksen ylläolevaan scriptiin pyydetään se samalla protokollalla kuin alkuperäinen pyyntö. Mikäli sivupyyntö tuli salaamattomalla http-protokollalla, haetaan myös scripti sillä. Mikäli pyyntö tuli salatulla https-protokollalla, haetaan scripti käyttäen sitä.

Protokollaneutraali viittaus on ainoa toimiva tapa silloin kun kaikkia tiedostoja ei voi / haluta laittaa samalle palvelimelle (esim content delivery networkit). Mikäli tiedosto sijaitsee samalla palvelimella (esim hakulomake) ei niitä muuteta protokollaneutraaleiksi vaan suhteellisiksi viittauksiksi.

Muutettavia kohtia PrettyBitServerissä

PrettyBitServerissä ei alunperin kaikki viittaukset ole olleet suhteellisia tai protokollaneutraaleja. Seuraavassa kohtia, joita voit joutua muuttamaan. Mitä tarvitsee muuttaa riippuu alkuperäisestä PrettyBitServerin versiosta ja siitä onko käytössä teemoja vai ei.

  1. Hakulomake ja siellä olevat scripti- ja tyylitiedosto-viittaukset (yleensä nämä ovat sivun yläosassa head-tagien välissä)
  2. Tyylitiedoston kuvat. Katso käytetyn tyylitiedoston sisältä. Oletustyylitiedostona käytetään \wwwroot\styles\search.css tiedostoa. Mikäli käytössä on ulkoasuteemoja tai kustomoituja ulkonäköjä, niin tiedosto on eri.
  3. HTML-kansion alla olevissa alikansioissa olevat lib_styles.inc ja/tai muut tiedostot, joissa viitataan tyyli ja scriptitiedostoihin.
  4. Settings-kansion alla oleva ”lib_scripts.ini” tiedoston viittaukset.


Uudemmissa PrettyBitServereissä kaikki linkit on muutettu protokollaneutraaleiksi, mutta tämä pätee vain seuraavissa tapauksissa:

  • PrettyBitServer on asennettu uudelle palvelimelle vuoden 2016 aikana julkaistulta medialta
  • Asetuksia ja/tai html-tiedostoja EI ole palautettu vanhalta palvelimelta