Teknika Zerbitzari-scriptak WCAG 2.2
SVR3Referer goiburua erabiltzea, beti bertsio irisgarritik pasatzeko lehenik
Izen ofiziala W3Cn: HTTP referer goiburua erabiltzea betetzen ez duen edukia eduki betetzailetik soilik eskuratu ahal izango dela bermatzeko
Laburbilduz
Eduki ez-irisgarri batek bertsio alternatibo irisgarri bat duenean, zerbitzariak egiazta dezake pertsona zer orritatik datorren. Horretarako, script batek (PHP, ASP, JSP…) HTTP Referer goiburua irakurtzen du. Bertsio irisgarritik ez badator, hartara eramaten du, eta handik bestea aukera dezake.
Zergatik da garrantzitsua
Pentsa ezazu lineako ikastaro bat, pantaila-irakurgailuek irakurri ezin duten tresna batekin egindako simulazioak dituena. Gauza bera azaltzen duen orri irisgarri bat badago, komeni da lehenik hartatik igarotzea.
Horrela, inor ez da bertsio ez-irisgarrian harrapatuta geratzen bilatzaile batetik edo esteka zuzen batetik iritsi delako. WCAGek bertsio alternatibo betetzaileei (informazio bera duten bertsio irisgarriei) buruz ezartzen duten baldintza betetzeko modu bat da.
Nola egiten da
- Orri ez-irisgarri bakoitzerako, idatzi haren bertsio irisgarriaren helbidea.
- Orri ez-irisgarriaren eskaera jasotzean, irakurri
Referergoiburua. Pertsona zer orritatik datorren adierazten du. - Alderatu helbide hori bertsio irisgarriarenarekin. Ez kontuan hartu garrantzirik gabeko desberdintasunak, hala nola
?ikurraren ondorengo parametroak edo#ikurraren ondorengo zatia. - Bat badatoz, zerbitzatu eskatutako orria. Bestela, birbideratu bertsio irisgarrira.
- Sartu bertsio irisgarrian beste bertsiorako esteka argi bat, hura erabili nahi duenarentzat.
Nola egiaztatu
- Idatzi zuzenean helbide-barran orri ez-irisgarriaren URLa.
- Egiaztatu zerbitzariak bertsio irisgarrira eramaten zaituela.
- Bertsio irisgarritik, sakatu beste bertsiorako esteka eta egiaztatu oraingoan ireki egiten dela.
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko SVR3 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.
Aplikagarritasuna
Zerbitzariaren aldeko scripten bidez sortutako edukia, HTTP Referer goiburuaren arabera edukiaren bertsio betetzaile bat bertsio ez-betetzaile baten alternatiba gisa ematen denean.
Deskribapena
Teknika honen helburua da erabiltzaileek edukiaren bertsio irisgarri bat lortu ahal izatea bermatzea, bertsio ez-betetzaileak zein betetzaileak ematen direnean.
1. betetze-baldintzak aukera ematen du orri ez-betetzaileak betetzearen esparruan sartzeko, betiere bertsio alternatibo betetzaile bat badute. Egileek ez dute beti eduki ez-betetzailearen barrutik eduki betetzailerako esteka irisgarriak sartzerik. Hortaz, baliteke egileek zerbitzariaren aldeko script-teknologietara jo behar izatea (adibidez, PHP, ASP, JSP), bertsio ez-betetzailera orri betetzaile batetik soilik iritsi ahal izango dela bermatzeko.
Teknika honek deskribatzen du nola erabili HTTP referer goiburuak ematen duen informazioa eduki ez-betetzailera orri betetzaile batetik soilik iritsi ahal izango dela bermatzeko. HTTP referer goiburua erabiltzaile-agenteak ezartzen du, eta erabiltzaile-agentea orri ez-betetzailera bidali duen orriaren (halakorik bada) URIa dauka.
Teknika hau ezartzeko, egileak orri ez-betetzaile bakoitzerako edukiaren bertsio betetzailearen URIa identifikatzen du. Orri baten bertsio ez-betetzailerako eskaera bat jasotzen denean, zerbitzariak HTTP referer goiburuaren balioa bertsio betetzailearen URIarekin alderatzen du, bertsio ez-betetzailerako esteka bertsio betetzailetik datorren zehazteko. Bertsio ez-betetzailea HTTP referer goiburua bertsio ez-betetzailearen URIarekin bat datorrenean soilik zerbitzatzen da. Bestela, erabiltzailea edukiaren bertsio betetzailera birbideratzen da. Kontuan izan HTTP referer goiburuko URIa alderatzean URIaren garrantzirik gabeko aldaerak hartu behar direla kontuan, hala nola kontsulta-katearenak eta helburu-zatiarenak.
Adibideak
Prozesu fisikoen erakustaldi interaktiboak
Lineako fisika-ikastaro batek modelatze-lengoaia jabedun bat erabiltzen du prozesu fisikoen erakustaldi interaktiboak eskaintzeko. Modelatze-lengoaiaren erabiltzaile-agentea ez da laguntza-teknologiekin bateragarria. Webguneak HTTP referer goiburua erabiltzen duen script bat dauka, erabiltzaileak erakustaldi interaktibora prozesuaren eta modeloen deskribapen betetzaile bat duen orri batetik sartzen saiatzen ez badira, zerbitzariak eskaera bertsio ez-betetzailerako esteka bat duen orri betetzaile batera birbidera dezan bermatzeko. Ikasleek bertsio interaktibo ez-betetzailera sartzea aukera dezakete, baina hala egiten ez dutenek ere prozesuari buruz ikas dezakete.
HTTP referer goiburua PHPn erabiltzea
Ondorengo adibideak erakusten du nola erabil daitekeen teknika hau PHPn. Bi fitxategi ditu, conforming.php eta non-conforming.php, elkarrekin lan egiten dutenak eduki ez-betetzailera sartzeko modu bakarra eduki betetzailetik izan dadin bermatzeko.
PHP betetzailea
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Conforming Content</title>
</head>
<body>
<h1>This is a conforming page</h1>
<p>From here, you can visit the <a href="non-conforming.php">non-conforming
page</a>.</p>
</body>
</html>
PHP ez-betetzailea
<?php
// if the request comes from a file that contains the string "conforming.php"
// then render the page
if(stristr($_SERVER['HTTP_REFERER'], "conforming.php")) {
?>
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Non-Conforming Content</title>
</head>
<body>
<h1>This is a non-conforming page</h1>
<p>Because you came from <?php echo $_SERVER['HTTP_REFERER']; ?>,
you are able to view the content on this page.</p>
</body>
</html>
<?php
}
// if the referring page is not conforming.php, then redirect the user to
// the conforming version
else {
header("Location: conforming.php");
}
?>
Adibide funtzionala: eduki betetzailea.
Probak
Prozedura
Eduki ez-betetzailerako WCAG betetzen dituzten alternatibak ematen direnean:
- Identifikatu adierazitako betetze-mailan WCAG betetzen ez dituzten orriak, alternatiba irisgarriak HTTP Referrer goiburuaren arabera ematen direnean.
- Bisitatu eduki ez-betetzailearen URIa.
-
Egiaztatu ondoriozko orria hauetako bat dela:
- eduki ez-betetzailearen bertsio alternatibo betetzaile bat
- bertsio alternatibo betetzailerako zein eduki ez-betetzailerako esteka bat duen orri bat
Espero diren emaitzak
- 3.1. edo 3.2. egiaztapena egiazkoa da.
Nola egiaztatzen dugun ADDAWn
ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.
W3Cren SVR3 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.