Korisnički plug-inovi

Korisnički plug-inovi se koriste s trenutnim korisnikom konteksta. Ova tema sadrži dodatne informacije za neke od ovih plug-inova.

Plug-in prikaza lokalizacije

Koristite Locale plug-in prikaza za dodavanje informacija lokalizacije u vaš Web sadržaj ili za umetanje markupa u vaš Web sadržaj, zavisno o trenutnoj lokalizaciji. Ovaj plug-in određuje preferiranu podržanu lokalizaciju u trenutnom kontekstu.

Locale plug-in prikaza koristi sljedeće atribute:
acceptLanguage
Definira jednu ili više preferiranih lokalizacija koje se mogu izabrati portalom u određenom kontekstu. Vrijednosti atributa moraju biti u skladu sa specifikacijom sintakse za polje Accept-Language zaglavlje u HTTP/1.1 protokolu. Za detalje o ovom polju zaglavlja pogledajte Accept-Language odjeljak u RFC2616 specifikaciji.

Ako acceptLanguage atribut nije definiran, portal smatra da su sve dostupne i podržane lokalizacije jednako prihvatljive kad se preferirana podržana lokalizacija određuje za izabrani kontekst.

pattern
Definira izlazni format lokalizacije koju ispisuje Locale plug-in.
Vrijednosti atributa navode uzorak koji može uključiti sljedeće držače mjesta:
  • {language}: Znak rezerviranog mjesta za mala slova, dvoslovnu šifru jezika za lokalizaciju, kako je definirano s ISO-639 standardom.
  • {country}: Znak rezerviranog mjesta za velika slova, dvoslovne šifre zemlje za lokalizaciju, kako je definirano s ISO-3166 standardom.
  • {variant}: Znak rezerviranog mjesta za varijantu lokalizacije specifičnu za dobavljača ili za pretražitelj.

Ako pattern atribut nije definiran, koristi se sljedeći uzorak: {language}-{country}-{variant}.

printLocale
Definira da li se preferirana, podržana lokalizacija koju određuje Locale plug-in umeće u vaš Web sadržaj. Atribut može imati sljedeće vrijednosti:
  • true: Preferirana podržana lokalizacija se zapisuje u markup stranice.
  • false: Preferirana podržana lokalizacija se ne zapisuje u markup stranice.
Kombiniranjem ovog atributa s acceptLanguage atributom korisnici mogu definirati sadržaj koji se treba prikazivati samo u sljedećim situacijama:
  • Ako je određena lokalizacija primjenjiva u trenutnom kontekstu
  • Ako je jedna lokalizacija iz određenog skupa lokalizacija primjenjiva u trenutnom kontekstu
Iako se tijelo Plugin oznake ispisuje ako je neka prihvatljiva lokalizacija podržana, preferirana podržana lokalizacija se ne prikazuje kad je ovaj atribut postavljen na false.

Ako printLocale atribut nije definiran, koristi se vrijednost true.

This information applies to CF08 and laterkey
Kao alternativu za prethodno navedene atribute, možete koristiti atribut ključ za dohvaćanje dodatnih podataka lokalizacije. Podržane vrijednosti su:
  • direction: Upisuje osnovni smjer teksta preferirane podržane lokalizacije zahtjeva u vaš web sadržaj. Na primjer: "ltr".
  • xmlLocale: Upisuje prikaz preferirane podržane lokalizacije zahtjeva u obliku niza znakova, kao što je definirano s IETF BCP 47, u vaš web sadržaj. Na primjer: "en".

Ako Locale plug-in navodi tijelo sadržaja, markup između početne i krajnje oznake se prikazuje samo ako je određena preferirana, podržana lokalizacija. Ako se niti jedna podržana lokalizacija ne primjenjuje u trenutnom kontekstu, plug-in Locale ne umeće markup u sadržaj.

Primjeri:
  • Kad dodate Locale plug-in bez definiranja više atributa, preferirana, podržana lokalizacija u trenutnom kontekstu se umeće u vaš Web sadržaj. Koristi se default format za {language}-{country}-{variant} (na primjer, es-ES-WIN):
    [Plugin:Locale]
  • Atribut pattern definira izlazni format preferirane, podržane lokalizacije. Sljedeći primjer prikazuje lokalizaciju s prilagođenim formatom i izostavlja element varijante (na primjer, es_ES):
    [Plugin:Locale pattern="{language}_{country}"]
  • Sljedeći primjer prikazuje šifru jezika za preferiranu, podržanu lokalizaciju u trenutnom kontekstu (na primjer, da). Samo jezici nordijskih država se prihvaćaju kao rezultat. Ako nije podržana niti jedna od navedenih lokalizacija u trenutnom kontekstu, ništa se ne ispisuje u vaš Web sadržaj. Na primjer, ako korisnik konfigurira Web pretražitelj ili profil korisnika portala tako da se koristi samo engleski (en), Locale plug-in ne vraća nikakvu lokalizaciju.
    [Plugin:Locale acceptLanguage="da,fo;q=0.8,fi;q=0.6,is;q=0.4,no;q=0.2,sv;q=0.2" 
pattern="{language}"]
  • Možete spriječiti prikaz preferirane, podržane lokalizacije s printLocale atributom. Ovaj primjer umeće tijelo Plugin oznake u Web sadržaj samo ako preferirana, podržana lokalizacija odgovara jednoj od navedenih nordijskih jezika. Određena lokalizacija se ne dodaje u Web sadržaj.
    [Plugin:Locale acceptLanguage="da,fo;q=0.8,fi;q=0.6,is;q=0.4,no;q=0.2,sv;q=0.2" 
printLocale="false"]
     <div>This markup is displayed only if the current context supports a locale 
     that represents one of the specified Nordic languages.</div>
 [/Plugin:Locale]
  • Možete također kombinirati Locale plug-in s drugim plug-inovima. Sljedeći primjer pokazuje kako možete koristiti Matches plug-in s Locale plug-inom. Markup u tijelu Matches plug-ina se prikazuje u vašem sadržaju samo ako je preferirana, podržana lokalizacija ona za španjolski.
    [Plugin:Matches pattern="es(.*)" text="[Plugin:Locale]"] 
    <div>This markup appears only if the preferred supported locale in the 
    current context represents a Spanish language. Neither the country code 
    nor the variant are important as long as the language code of the 
    locale is "es".</div>
[/Plugin:Matches]
  • Za upis osnovnog smjera teksta za preferiranu podržanu lokalizaciju zahtjeva u vaš web sadržaj, poput "ltr", koristite atribut ključ sa smjerom: 
    [Plugin:Locale key="direction"]
  • Za upis preferirane podržane lokalizacije zahtjeva u obliku niza znakova kako se definira s IETF BCP 47 u vaš web sadržaj, poput "en", koristite atribut ključ s vrijednosti xmlLocale: 
    [Plugin:Locale key="xmlLocale"]

If Device i If Not Device plug-inovi

Koristite If Device i If Not Device plug-inove za selektivni prikaz sadržaja, bazirano na klasi uređaja korisnika portala. Te plug-inove možete koristiti za prebacivanje na mobilne komponente, poput slideshowa ili vrtuljka optimiziranog za mobilne uređaje kada korisnik pristupi stranici pomoću smartphonea ili tableta.

Atribut klase se definira pomoću klasifikacija uređaja za podržane klijente u IBM® WebSphere Portal. Prijavite se na WebSphere Portal kao administrator i kliknite ikonu izbornik Administracija na traci s alatima. Zatim kliknite Postavke portala > Podržani klijenti. Uredite izabranog klijenta tako da koristi klase koje su mu već pridružene. Na ovoj stranici možete dodati ili ukloniti klase.

Pomoću sljedećeg formata možete provjeriti da li se određeni uređaj koristi:
[Plugin:ifDevice class="DEVICE1" class="DEVICE2"]
Text to render if current device is DEVICE1 or DEVICE2.
[/Plugin:ifDevice]
Pomoću sljedećeg formata možete provjeriti da li se određeni uređaj ne koristi:
[Plugin:ifNotDevice class="DEVICE1" class="DEVICE2"]
Text to render if current device is not DEVICE1 or DEVICE2.
[/Plugin:ifDevice]
Ako uređaj nije postavljen, koristi se sljedeće:
[Plugin:ifDevice class=""]
Text to render if the device is not set.
[/Plugin:ifDevice]
Za specificiranje jednog ili drugog uređaja, koristite ovu sintaksu:
[Plugin:ifDevice class="DEVICE1|DEVICE2"]
Text to render if current device is DEVICE1 or DEVICE2.
[/Plugin:ifDevice]
Za specificiranje jednog i drugog uređaja koristite ovu sintaksu:
[Plugin:ifDevice class="DEVICE1+DEVICE2"]
Text to render if current device is DEVICE1 and DEVICE2.
[/Plugin:ifDevice]
Za specificiranje jednog, ali ne i drugog uređaja koristite ovu sintaksu:
[Plugin:ifDevice class="DEVICE1+!DEVICE2"]
Text to render if current device is DEVICE1 but not DEVICE2.
[/Plugin:ifDevice]