TLWWW használat

Újdonságok

1.1. Online kártyás fizetés - 1676

Ezen opciót megvásárló könyvtár olvasóinak lehetősége van tartozásaik online kifizetésére. Az OTP Mobil Simplepay.hu rendszer segítségével lehet bankkártyával fizetni.

1.1.1. Használata

Az olvasó a webes felületen megnézi az Olvasói állapotát. Ha van tartozása, akkor megjelenik az Összesen sorban a Online fizetés gomb is.

1. ábra: Olvasói állapot
kep

A gombra kattinva eljut a fizetési oldalra. Innen elérheti a SimplePay vásárlói és adatkezelési tájékoztatót. Itt újra megnézheti a tartozásait. Ha ad a könyvtár engedményt a tartozásból (pl. megbocsátás hete), az a tartozások listájának végén látszik.

Itt kell elfogadni az adattovábbítási nyilatkozatot, csak ezután lehet átlép a SimplePay oldalra a Tovább a fizetésre gombbal.

2. ábra: Nyilatkozat elfogadás
kep

A Simplepay oldalon történik a tényleges fizetés.

3. ábra: Tényleges fizetés
kep

A fizetés befejeztével visszakerül az olvasó TLWWW-hez, ahol a fizetés sikerességéről kap információt.

4. ábra: Sikeres fizetés
kep
5. ábra: Sikertelen fizetés
kep

1.1.2. Beállítások - rendszergazda

Az opciót megvásárló könyvtár az infokertől megkapja a futtatáshoz szükséges .php fájlokat. Ezeket a TLWWW fájlok mellé (pl. /var/www/tlwww/) érdemes tenni. Lehet más mappába is, de a .php fájloknak ugyanazon a gépren kell lenniük, mint ahol a TLWWW fut, mert el kell érniük a TLWWW oldalakhoz tartozó cookie-kat!

Példáinkban a kvt.hu-t használjuk a TLWWW site neve helyett.

Első feladat a SimplePay beállítása. Az src/config.php fájlban kell ezt megtenni. A teszt rendszer beállítás (sandbox) először még maradjon true. Ilyesmi lesz: 

'HUF_MERCHANT' => "DEV121212",  // SimplePay azonosítónk
'HUF_SECRET_KEY' => "5rAm230q", // SimplePay API kulcsunk
... 
'SANDBOX' => true,

Utána a TextLibhez tartozó beállításokat kell megtenni. Az online kedvezmény mértékét és a hozzá tartozó szöveget a tlconfig.php fájlban állíthatjuk be. Ha nem akarunk kedvezményt adni, ezt a két sort kommentezzük ki. 

$TLdiscount = 15; // szazalek
$TLdiscountTXT="Megbocsátás hete okt. 10-17, 15% engedmény: <a href=kvt.hu/mbhet.html>info</A>";

A tlwww.cfg-ben is be kell allítani pár dolgot:

A tlwww.css fájlban csak akkor kell módosítani, ha a weboldalakon a gombok kinézetét változtatnánk. A css fájl végén a .paybutton beállításokat kell átírni.

Az OTP Mobil-nál kezdeményezni kell, hogy próbálják ki az online fizetést. Ha ők jóváhagyják, hogy mehet a dolog élesben is, akkor kell az src/config.php-ban beállítani: 

'SANDBOX' => false,

1.1.3. Tesztelés - rendszergazda

A tesztelés idejére a tlconfig.php fájlban be lehet állítani a TLteszt változót. A TESZT_KIIR a weboldalra kiiírja a küldött és kapott paramétereket. A TESZT_NOTART esetén a sikeres fizetés után nem történik meg a tartozások rendezése. Ily módon egyetlen olvasóval lehet többször is próbálni a fizetési tranzakciót magát. 

$TLteszt = TESZT_KIIR + TESZT_NOTART;

A TLWWW online fizetés oldalain a legfelső sorban látszik, hogy a teszt beállítások közül melyek vannak érvényben:

6. ábra: Teszt üzemmód
kep

A tesztelés befejeztével a TLteszt változót false-ra kell állítani.

1.1.4. Fájlok

1.2. Saját javascript használata

Ez már régóta működik, de a leírása valahogy kimaradt :-(

A TLWWW által generált html oldalak HEAD részébe be lehet illeszteni egy saját javascript kódot. A fájl nevét a tlwww.cfg-ben kell megadni: 

user_js=/tlwww/sajatunk.js

Itt lehet definiálni olyan függvényeket, amiket a tlwww.js is meghív.

Ebben a fájlban lehetnek persze saját javascript kódok is.

Példa sajatunk.js: 

// Az [Interneten] mezőben nagy méretű képekre van hivatkozás.
// A dokumentum oldalakon kis méretű képeket akarunk csak megjeleníteni
// A kis képre kattinva lehet aztán a nagy méretűt megnézni.
// Pl: xxx.hu/kep/b/b3423.jpg helyett xxx.hu/kep/kicsi/b/b3423.jpg
function TlUserSmallPic( url )
{
   url = url.replace("konyvtarunk.hu/kep/","konyvtarunk.hu/kep/kicsi/");
   return url;
}

// Az [Interneten] mezőben DVD borítókra van hivatkozás
// Pl: xxx.hu/dvd/borito/b3423.jpg
// A dok.oldalon megjelenő link szövegét adhatjuk meg így
function TlUserLinkName( name, url )
{
    if( name.indexOf('xxx.hu/dvd/borito/') > 0 )
        return 'DVD borító';
}

// Saját script
function sajat() { }
// A html lap betoltese utan hivodik a tlwww.js:TlWwwOnload()-bol
function TlUserOnload() { sajat(); }

1.3. Fiókbeli foglalás letiltása

Ha egy fiókban a foglalást átmenetileg le akarjuk tiltani (pl. bezár a fiók júliusra), akkor a rendszergazda a winkliens Rendszer / Könyvtárunk adatai ablakban a FiókNemFoglal: mezőben megadja azon fiókokat, amikben nincs foglalás:

7. ábra: Fiókok megadása
kep

A webes felületen ezeknél a fiókoknál nem is jelenik meg a Foglalás gomb:

8. ábra: Nincs Foglal gomb az adott fiókoknál
kep

1.4. Minta keresés

A minta alapján zajló keresés azt jelenti, hogy amikor nem ismerjük pontosan a keresendő nevet, címet vagy mást, akkor megadhatunk egy mintát, amiben az ismeretlen részeket kérdőjelekkel helyettesítjük. A kérdőjel akárhány betűt helyettesíthet.

A legelső karakter nem lehet kérdőjel, ekkor a keresés nagyon sokáig tartana, ezért el sem indul. Ha egy karaktert adunk meg a kérdőjel előtt, esetleg időtúllépés miatt leáll a keresés. Min. két karakternél már nem várható probléma. Ez az adott indexfájl méretétől (pl. a Szavak index lényegesen nagyobb, mint az UK-azon) és a TextLib szerver gép sebességétől függ.

Minta alapján az egyszerű és a részletes keresés bármelyik keresőmezőjében kereshetünk.

Nézzünk néhány konkrét példát, a Cím indexben keresésre:

1.5. Hordozó ikonok - pár újabb

Újabb hordozó ikonok. Pl. plakát, mikrofilm. Ezek használata tlwww.cfg-ben: 

ikon.mp3=ik_mp3.png
ikon.Plakát=ik_plakat2.png
#ikon.Plakát=ik_plakat.png
ikon.fekete-fehér kép=ik_kep2.png
ikon.microfilm*=ik_micro.png
ikon.mikrofilm*=ik_micro.png
ikon.mikroforma=ik_micro.png

1.6. chktlwww: TLWWW ellenőrzés

Linuxon régóta a TLWWW része az ellenőrző program (chktlwww). Ez néhány percenként ellenőrzi, hogy a TLWWW működik-e rendesen. Ha nem, akkor emailt küld, hogy mielőbb újra lehessen indítani. Esetleg ő maga újraindít ;-)

A chktlwww részletes leírása régóta megtalálható a linuxos leírásban, de most itt is felhívtuk rá a figyelmet.

1.7. A vak.htm testreszabása

A gyengénlátók által használt oldalt is lehet kicsit állítgatni. elsőre annyit, hogy legyen-e olvasói belépés az oldalon. Erre való az OlvAllapot opcio. Egy példa vak.cfg: 

# vak.cfg - vak.htm config fajl
# Output file - oda kerul, ahol a html oldalak vannak egyebkent is
vak.htm

# Könyvtár neve
Teszt Könyvtár
# Konyvtar honlapja (url) - Ide visz majd a [Honlap] gomb
www.enkonyvtaram.hu

# Olvasoi belepes legyen-e? Akkor + jel legyen a sor elejen:
-Olvallapot

1.8. TLWWW beállítások TlApp használata esetén

A TlApp Androidos applikáció használatához kell néhány beállítás a TLWWW-ben. A TlApp is a tlwww-től kérdezi le az adatokat.

Az app.cfg fájlban ugyanúgy lehet megadni a beállításokat, mint ahogy a fulek.cfg-ben. A tlwgen.exe program futtatása szükséges a cfg változtatása után! Ezzel létrejön az app.htm, amit a TlApp használ.

Módosítani kell az app_info.htm html fájlt. Ez a TLWWW felújításkor jön létre, ha még nem létezik a fájl. Ez a könyvtár 'névjegye'. Ezt a html oldalt látja majd az olvasó, amikor TlApp-ban a főmenüből a Könyvtár info menüpontot választja.

Ide be lehet írni telefonszámot is. Ha ebben a formában tesszük, akkor a linkre kattintva egyből fel is tudja hívni az olvasó a számot: 

<a href="tel:+36-30-111-1111">30-111-1111</a>

Az oldalak kinézetét az app.css fájlban lehet állítgatni.

1.9. 1644 újdonságok - 1644

1.10. 1640 újdonságok - 1640

1.10.1. tlwww / windows - PHP programok

A Windowsos TLWWW immáron tud PHP programokat is futtatni. Mivel támogatja a CGI/1.1 specifikációt. Aki a tlwww statisztika opciót használni akarja, annak erre mindenképp szüksége lesz, mivel az egy php program.

A lehetőség használatához

1.10.1.1. PHP telepítése és a php.ini

Javasolt egy PHP 7.3-nál újabb verzió (esetleg 5.6.39, ha szükséges), ami innen letölthető. Például

Minimum Windows Vista kell a PHP futtatáshoz.

A zip fájlt ki kell tömöríteni pl. a c:\php mappába.

Létre kell kell hozni a php.ini fájlt a következő módon. Indítunk egy parancssor ablakot (CMD.EXE), abban: 

cd /d c:\php
copy php.ini-production php.ini

Néhány beállítást érdemes megváltoztatni a php.ini-ben, pl. a notepad program használatával (nem word!). Így a php fájlok végrehajtása közben fellépő hibák a TLWWW konzoljára íródnak ki: 

display_errors = off
display_startup_errors = on
log_errors = on
fastcgi.logging = 1

Érdemes kipróbálni, hogy működik-e rendesen a PHP. A korábban indított parancssoros ablakban ezzel: 

cd /d c:\php
php-cgi.exe --version

Ha kiírja a PHP verziót, ami valami ilyesmi: 

PHP 5.6.38 (cgi-fcgi) (built: Sep 13 2018 12:25:29)
Copyright (c) 1997-2016 The PHP Group
Zend Engine v2.6.0, Copyright (c) 1998-2016 Zend Technologies

akkor működik. Ha nem indul el (pl. "This application failed to start because msvcrt.dll was not found", "php-cgi.exe is not a valid win32 application"), akkor szükséges lehet a Visual /C++ 2012 redistributable csomag telepítése is.

1.10.1.2. tlwww.cfg beállítás

Meg kell adni a tlwww.cfg-ben, hogy hol található a php interpreter. Ha ez nincs megadva, akkor a TLWWW a .php kiterjesztésű fájlokra 500-as HTTP hibát ad vissza. 

# PHP program hasznalata (5.6.x javasolt)
php=c:\php\php-cgi.exe

Ha akarjuk az index.php-t kezdőlapként használni (pl. 'www.xxx.hu/mappa/index.php' URL helyett csak 'www.xxx.hu/mappa/' kelljen írni), akkor ez a sor is kell: 

DefaultFiles=homepage.htm;index.html;index.php

1.10.2. tlwww / windows - https beállítás

A TLWWW/https opció windows alatt is használható, így a böngésző és a TLWWW közötti kommunikáció titkosítottan zajlik.

Létre kell hozni egy nyilvános kulcsot (CSR), és vásárolni valahol SSL tanúsítványt. Olcsó és megbízható szerintünk a Szerverplex. A textlib.hu gépünk is náluk fut évek óta.

Van több ingyenes lehetőség, jónak tűnik például a sslforfree.com. Ez a Let's Encrypt oldalt használja. Az itt készült tanúsítványokat sajnos 3 havonta meg kell újítani...

A tlwww/win program mappájában a tlwww.cfg fájlba be kell írni a következő sorokat: 

## HTTPS beallitasok
# 0:HTTP 1:HTTPS 2:HTTP+HTTPS 3:HTTP+HTTPS+REDIRECT
https = 2
# port megadasa, altalaban 443
bindssl = any:443
# ssl CERT, CA, ROOT CA - a sajat certificate mindig ebben!
cert = c:\titkos\certificate.crt
# ssl private key
pkey = c:\titkos\private.key
# ha kulon fajlban vannak meg certificate-ek, akkor:
#cacert=c:\titkos\ca_bundle.crt    # ha meg van adva akkor ezt is betolti

A https beállítás azt adja meg, hogy csak http (0), csak https (1) vagy mindkét (2) protokol használható. A 3 pedig azt jelenti, hogy a http kérések automatikusan át lesznek írányítva https-re.

A private.key fájlban kell legyen a privát kulcs. Ha nincs megadva pkey kulcs a tlwww.cfg-ben, akkor a cert kulcs által megadott fájl az alapértelmezett .key kiterjesztéssel. A tartalma ilyen: 

-----BEGIN PRIVATE KEY-----
...
-----END PRIVATE KEY-----

1.11. 1635 újdonságok - 1635

1.12. 1634 újdonságok - 1634

1.13. 1633 újdonságok - 1633

1.14. 1632 újdonságok - 1632

1.15. 1629 újdonságok - 1629

1.16. 1628 újdonságok - 1628

1.17. 1627 újdonságok - 1627

1.18. 1625 apróságok - 1625

1.19. 1624 apróságok - 1624

1.20. 1623 apróságok - 1623

1.21. Be nem lépett olvasók 2. - 1623

Megadható egy URL részlet is a ProcessBaseUrl-nél, nem csak az URL eleje, mint eddig. Pl.: #tlvedett

Ez bármilyen URL végére odaírható, az URL működik. De TLWWW-ben csak a belépett olvasó láthatja. Pl: Olvasószolgálat dokumentáció

Az ezt megadó tlwww.cfg részlet: 

ProcessBaseUrl=#tlvedett

1.22. Be nem lépett olvasók - 1622

Nem belépett olvasók elől el lehet rejteni bizonyos Interneten: mezőbeli linkeket.

tlwww.cfg beállítás: 

##### Interneten mezo linkjei - nem belepett olvaso eseten
# Ha ilyen kezdetű az URL, akkor kell tenni valamit.
ProcessBaseUrl=www.konyvtaram.hu/titkos/
# Vagy lehet pl. valami script is:
#ProcessBaseUrl=www.konyvtaram.hu/kivonat=
# Ezt kell kiírni a megjelenő szöveg elé. Kerül mögé ':' is.
# Ebből lesz pl.: Belépve:Kivágat
ProcessChangeTxt=Belépve
# Ez a linkhez tartozo TITLE
ProcessChangeTitle=Be kell lépnie a tartalom megnézéséhez

1.23. tlshow/dref URL-ek - 1620

Windowsos tlwww-ben a dokumentum oldalak (pl. a b1234 rekord) az eddigi /cgi-bin/tlww.cgi?show=b1234 mellett a /tlshow/b1234 URL-el is elerheto. Ez jól jöhet, ha pl. a Google-nek meg akarjuk engedni, hogy keressen a dokumentum oldalak között.

Az ilyen módon lekért html lapokba a "Last-Modified" mezőt a rekord utolsó módosításának dátumára állítja a tlwww.

1.24. Hordozó ikonok - 1616

A szövegesen megjelenő hordozó/dok.típus helyett lehet ikonokat is használni. Sokkal látványosabb, főleg a találati listában. Látszik egyből, melyik a DVD, az LP, a kotta, és melyik a könyv.

Lásd: ezen a példán

tlwww.cfg-ben kell megadni, ha ikonokat akarunk a szövegek helyett. Itt lehet megadni azt is, milyen hordozó/dok.típus milyen ikonnal jelenjen meg. Adunk néhány ikont mintának. Aki küldd nekünk jobbat, vagy valami hiányzót, azt megköszönjük :-)

A tlwww.cfp-ben jópár példát lehet találni, milyen hordozó esetén milyen ikont kell mutatni. Ezt érdemes egy az egyben átmásolni a tlwww.cfg-be. Vannak rövidítések több helyen is (hgk. = hangkazetta). A megyei könyvtári adatbázisokat néztük végig.

Egyelőre az ikon. utáni szövegeket ISO-8859-2 kódolással kell megadni! 

##### Hordozo/dok.tipus ikon
#Ikon a szoveg helyett: be/kikapcsolva. Default: off
ikon=on
#A lentebb meg nem adott hordozoknal ez legyen az ikon
ikon.default=ik_def.png
#A fontosabb infhordozo/hordozo ertekekre az ikonok
#* karakter helyen barmilyen szoveg allhat 
ikon.Könyv=ik_konyv.png
ikon.Közös adat=ik_kozos.png
ikon.DVD*=ik_dvd.png
ikon.CD*=ik_cd.png

1.25. Foglalás: részletesebb adatok - 1615

Az egérrel a Foglalás gombra állva az eddiginél több információt kapunk. Látszik, hogy hány napra lehet foglalni, hányat tudunk még foglalni az összesen hány lehetséges foglalásból. Ezek az újak. Az eddig is látszott, hogy mennyi a foglalás és az email/sms küldés ára.

Lásd: Egy konkrét példa

1.26. Hordozó/dok.tipus - 1615

Ezt a három dolgot ezentúl egy helyen látjuk a TLWWW-ben. Egyikük van kiírva, a másik kettő buborékban jelenik meg, ha egérrel a szöveg fölé megyünk. INFHORDOZO, HORDOZO, dok.tipus a fontossági sorrend. Az első olyan íródik ki, amelyik ki van töltve. A többiek kerülnek a buborékba. Nincs mindig mind a három mező kitöltve, de dokumentum tipus az mindig van.

Lásd: ezen a példán

1.27. Disszertáció: Oktatási forma - 1615

A disszertáció oldalon megjelenik a mező tartalma.

Lehet ezen mező alapján keresni és böngészni is.

1.28. Időszaki kiadvány új mezők - 1614

Időszaki kiadvány néhány mezője nem jelent meg eddig a WEBes felületen. Mint pl. Évfolyam, Számozás, Keltezés, Terjesztő.

Pedig ezekbe lehet beírni, hogy mely évfolyamok vannak meg a könyvtárban, mely évekből stb.

1.29. Alkotó tetszőleges adatai (1605)

Igazából ez már elég régóta van, csak elfelejtettük eddig ezt leírni.

Az alkotó rekordokba be lehet vinni tetszőleges adatokat, ami a WEB-es felületen remekül meg is jelenik. Meg lehet adni a mező nevét, kiirandó szöveget, és akár hivatkozásokat is. Ebben a példában a 'Pályafutás' és a 'Díjai' mezők így lettek bevive.

Winkliesben az Alkotó ablakban az 'Egyéb adatok:' mezőbe rögzítettem ezeket az ezen a képen látható módon.

1.30. Log fájlok megtartása - win/tlwww (1613)

Windows: Jelenleg 128 Kbyte logfájl méret után jön létre egy újabb log. Az előző log megmarad, az azelőtti törlődik.

Ha meg akarjuk tartani a régebbi logokat, azt most már lehet. Be lehet állítani, mekkora log fájlok legyenek, és hány darab legyen megtartva. 

# meret kilobyte-ban. Default: tlwww_log.txt
maxlogsize=512
# ennyi regi fajl maradjon meg: tlwww_log.1.txt, tlwww_log.2.txt...
logkeep=12

Linuxon nincs ilyen, mivel ott a linux saját logrotate programja intéz mindent. Az /etc/logrotate.d/textlib-www fájlban lehet mindent beállítani.

1.31. Mások keresték - lista hossza (1613)

A tlwww.cfg-ben be lehet állítani, hogy a 'Mások keresték' listában hány keresés látsszon. 
maxmasok=100

1.32. Nincs találat - keresési tippek (1612)

Meg lehet adni egy URL-t is, amit a TLWWW letölt, és az innen kapott szöveget is beszúrja a 'Nincs találat' oldalra. Ha volt megadva tlnotfoundtxt, akkor az után a szöveg után.

Az URL lehet pl. egy php program. Ez megkapja paraméterként, hogy mire kerestek, milyen beállításokkal. Javasolhat pl. más keresést, ha úgy találja, hogy elírás lehetett az eredménytelenség oka :-)

Készítettünk egy tlnotfound.php programot, ami pont ezt teszi. Akinek ez megfelel, használhatja ezt, aki sajátot akar írni, azt is megteheti. A miénk használatához tlwww.cfg-be ez kell: 

tlnotfoundurl=http://textlib.hu/tlnotfound.php

Ez a program megpróbálja kijavítani az esetleges elírásokat. Pl.: alkmista ==> alkimista, Grdonyi ==> Gárdonyi, makrokonomia ==> makroökonómia :-)

Javasolhat másik indexet. Pl. a szerző indexben keresés helyett az Alkotó indexben keresést. A cím indexben keresés helyett a cím szavaiban keresést.

Próbálható:

Cím:alkmista

Szavak:Egri csillagk

1.33. Nincs találat oldal testreszabása (1609)

Az eddigi egyszerű 'Nincs találat' szöveg lecserélhető, ehhez a tlwww.cfg-ben meg kell adni egy fájlt, amiben a szöveg van. Ebben lehetnek akár HTML tagek is. Kódkészlete utf8. 

tlnotfoundtxt=/usr/share/tlwww/sajat-szovegem.txt
Ha mégsem utf8-ban van, akkor meg kell adni a karakterkészletet is: 
tlnotfoundtxt=/usr/share/tlwww/sajat-szovegem.txt:iso-8859-2

1.34. Süti kezelés engedélyezése (1609)

Akarhatunk felugró ablakot, amiben tájékoztat a böngésző arról, hogy weboldalunk sütiket használ.

Természetesen ez az ablak csak egyszer jelenik meg, ha egyszer tudomásul lett véve, többet nem fog zargatni. Kivéve, ha töröljük a sütiket, mert akkor megintcsak feltűnik.

A beállításhoz két dolgot kell tennunk:

1. A fulek.cfg-ben: 

+Cookiewarn cookiewarn.txt

2. Kell csinálni cookiewarn.txt fájlt. A tlwww felújító csomag tartalmaz egy cookiewarn.txt.pld fájlt, azt érdemes lemásolni cookiewarn.txt néven, majd javítani benne, pl. a link URL-jét.

A fulek.cfg módosítása után mindig le kell futtatni a tlwgen.exe programot!

1.35. Több kép a dukumentum oldalon (1608)

Dokumentum oldalakon a borító helyén több kép is meg tud jelenni. Első helyen a borító, utána az Interneten mezőben található URL-ek közül azok, amik .jpg, .png, .gif végződésűek.

Példa: VMK képeslap

1.36. Videó a dokumentum oldalon (1608)

Ha .mp4 videóra mutató linket teszünk az Interneten mezőbe, akkor a videót a dokumentum oldalán azonnal le is lehet játszani. Persze csak HTML5 böngészőkben. De lassan már minden böngésző ilyen :-)

Példa: Mamma Mia

1.37. MasholNem (1607)

Beállítható, hogy ha Részletes keresésnél településre (fiókra) szűkítést adunk meg, akkor a megjelenő könyveknél ne is látsszanak a más településen található példányok. Csak a keresett település példányai. Azért van egy link: Összes település mutatása Az összes megmutatásánál is van link, amivel vissza lehet térni a keresett település megmutatásához. Beállításhoz a fulek.cfg-ben kell: 

+MasholNem
tlwgen.exe futtatás szükséges utána. Eredménye mindössze annyi, hogy berak egy 
<input type=hidden name=kerpld value=1>
sort a form-ba. Ha saját kereső oldal van, abba ezt kell berakni.

Példa: VMK kereső oldal

1.38. Definiálható keresőkérdések (1607)

1.38.1. keresőkérdések / 1

Az alkotó, földrajz ... oldalakon található '--keresés--' listába fel lehet venni újabb kereséseket.

Adott formátumú névvel kell a keresőkérdést bevinni a textlibbe. A keresőkérdésnek egy paramétere kell legyen.

A neve 'tlwww-RT:XXX' alakú kell legyen. Ezt a keresőkérdés rekord WWW név: mezőjében kell megadni :-)

RT - rekord tipus - azt adja meg, melyik lapra szánjuk a keresést. Lehet: dokumentum, alkoto, foldrajz, tezaurusz, testulet, sorozat, peldany, mu, idoszam,

XXX: a keresőkérdés neve, ami a listában megjelenik Paraméterként a rekord főmezőjét kapja (alkotó neve, könyv címe,...)

A keresés dokumentumok (esetleg példányok, alkotók, testületek, ... azaz olyan rekordok, amik meg szoktak jelenni a webes felületen) halmazát kell előállítsa.

Példa: 'tlwww-alkoto:Ilyen nevű szerzők könyvei'

A roppant egyszerű keresőkérdés pedig: 'keress szerzo=%1'

1.38.2. keresőkérdések / 2

Lehet olyan keresőkérdést is készíteni, ami nem az alkotó nevét, könyv címét stb. kapja meg, hanem az adott rekord azonosítóját (dref). Így meg lehet különböztetni pl. az azonos nevű alkotókat.

Ilyenkor a keresőkérdés neve 'tlwww-RT-dref:XXX' alakú.

Pl: 'tlwww-alkoto-dref:Ennek a szerzőnek a könyvei'

1.38.3. keresőkérdések / 3

Olyan keresőkérdés is készíthető, ami megkapja paraméterül a TLWWW-be belépett olvasó dref-jét. Az ilyen kérdések csak akkor látszanak a listában, ha van belépett olvasó! A keresőkérdésnek két paramétere van. A második az olvasó drefje. Az ilyen kérdések nevének formátuma: 'tlwww-RT-olv:XXX' vagy 'tlwww-RT-olv-dref:XXX'

A '-dref' az előző pontban írtak szerint működik itt is.

Pl: tlwww-alkoto-olv-dref:Miket olvastam ettől a szerzőtől?

1.38.4. keresőkérdések / 4

Olyan keresőkérdés is készíthető, ami az olvasói állapot oldalon jelenik meg. Ez egy paramétert kap csak, neve: 'tlwww-olv-dref:XXX'

Ennek kivételesen nincs '-dref' nélküli változata, nehogy az azonos nevű olvasók miatt keveredés legyen :-)

Pl: tlwww-olv-dref:Az összes általam kikölcsönzött dokumentum

1.38.5. keresőkérdések / 5

A WEb-es felület többnyelvű, ezért nem lenne jó, ha az angol nyelvű oldalon magyarok lennének a keresőkérdések nevei. Ezért így érdemes a neveket megadni: 

tlwww-RT:magyar-név|eng:angol-név|ger:német-név
Persze csak a könyvtár webes felületén valóban használt nyelvekkel kell foglalkozni...

1.39. Kihagyandó indexek (1607)

A Részletes keresésből kihagyhatók indexek. A fulek.cfg-ben megadhatók indexek, amiket ki kell hagyni a részletes keresés adatlapról, fel kell sorolni az indexek neveit: 

+IndexKihagy kat ih

1.40. Alkotó/testület kép pótlás (1606)

Alkotó/Testület rekord megjelentésnél, ha nincs kép róla, TLWWW ki tud rakni helyette egy default képet.

Pl. ilyet: www.textlib.hu/tlwww/NincsAlkoto.png

A tlwww.cfg-ben lehet ezt beállítani: 

NincsAlkotoFoto=http://kvt.hu/kepek/NincsAlkoto.jpg
 NincsTestuletFoto=http://kvt.hu/valami/NincsTestulet.jpg

1.41. Keresőkérdés futtatás (1606)

Ha a rendszergazda bevisz keresokerdest, aminek a neve 'tlwww:xxx' alakú, akkor TLWWW-bol ezt konnyeden lehet futtatni. Keszithetunk linket, gombot, formot stb. 

www.kvt.hu/cgi-bin/tlwww.cgi?go=xxx&par1=alma&par2=korte
modon lehet keresest inditani. Annyi paramerert kell megadni, ahany parametert a keresokerdes var :-)

1.42. TlXpldOff

Az 'Egyszerű keresés' az helyből a könyvtári példányokat keresi csak. Ha ezt ki akarjuk kapcsolni, akkor a fulek.cfg-be kell ez: 

+TlXpldOff

Ezzel a 'Részletes keresés' fülön a Hatáskör: mezőben is a 'Minden dokumentum'-ot teszi aktuálissá, a 'Csak könyvtáriak' helyett.

1.43. Képek kezelése

1.43.1. Kisebb kép nem belépett olvasónak

Nem belépett olvasóknak kisebb méretű kép mutatása.

tlwww.cfg: 

# Milyen URL kezdetu kepekkel kell csinalni valamit?
 ProcessImageBaseUrl = www.konyvtaram.hu/kepek/vedett
 # Mit kell veluk csinalni? Ezt csak linuxban kell megadni
 # $1 input $2 output $w szelesseg $h magassag
 ProcessImage = convert $1 -resize "$wx$h" $2
 # Mekkorara kell atmeretezni. 
 ProcessImageWidth = xxx      // default: 256
 ProcessImageHeight= zzz      // default: 256

1.43.2. Kép átméretezés

Kép lekérése átméretezéssel: 

/cgi-bin/tlwww.cgi?pic=/pic/alma.jpg&width=320
 /cgi-bin/tlwww.cgi?pic=www.kvt.hu/pic/alma.jpg&height=320

1.44. Android WebApp

Az új TLWWW verziót az Android operációs rendszer WebApp-ként tudja kezelni. Ehhez az Androidos böngésző programban (pl. Chrome) meg kell hívni a 

http://sajatkonyvtarunkcime.hu/tlwww/m.htm
oldalt. Ezt aztán ki lehet rakni a kezdőképernyőre.

Chrome-ban: Menü / Hozzáadás a kezdőképernyőhöz menüpont

Így a továbbiakban ikonnal indítható a mobilra optimalizált tlwwww oldal, ami alkalmazásként jelenik meg az Androidos eszközön.

Ha saját ikont akarunk, annyi csak a feladat, hogy a TLWWW gépen a /tlwww/ mappába rakjunk icon64.png, icon128.png és icon196.png képeket. A képek mérete a nevükből látszik, az icon128.png az 128x128 pixel méretű.

1.45. Kereső oldal - fülekkel

Ha az új keresőlapot (a fülekkel) akarjuk használni a régi kereső lap helyett, akkor

- fulek.cfg-ben egyszer be kell állítani, hogy mely fülek kellenek, és hogy milyen HTML fájlt kell létrehozni. Érdemes itt homepage.htm-et megadni, ha a default keresőlapot akarjuk lecserélni... Lásd: fulek.cfg

- Mindig, amikor változtatunk valamit, utána le kell futtatni a tlwgen.exe programot, ami előállítja az új kereső oldalt. 

Linuxban: 
  cd /usr/share/tlwww
  ./tlwgen.exe

Ez a program minden felúítás után automatikusan lefut!

1.46. Saját help - kereső oldalon

A kereső oldalon minden fül mellett található egy help szöveg. Ez le lehet cserélni sajátra.

A fulek.cfg-ben megadhatjuk, hogy mely fülekre van szükség a kereső oldalon. Itt meg lehet adni egy fáljnevet is. Ha ezt tesszük, akkor annak a fájlnak a tartalma jelenik meg a defalt help helyett.

A Részletes keresés help lecserélése pl. így megy: 

+Egyszeru_kereses
+Reszletes_kereses   myful.Reszletes.txt
+Ujdonsagok

A myful.Reszletes.txt-be kell beírni azt a HTML kód részletet, amit látni akarunk a default help helyett.

Ez egy képet és videót is tartalmazó példa. Működés közben megtekinthető itt 

<a href="http://textlib.hu/pic/boritos1.jpg"><img TITLE="Példa kép. Klikk a nagyításhz!"
   src="http://textlib.hu/pic/boritos1.jpg" width=280 align=right></A>
Több szempont alapján lehet keresni egyszerre...
<BR><iframe class=video src="http://www.youtube.com/embed/MAzBdHzY3MI"
     frameborder="0" allowfullscreen></iframe>

A tlwgen.exe futtatas szükséges!

1.47. Saját fül - kereső oldalon

A kereső oldalon saját fület is definiálhatunk. Az 'Egyszerű keresés' és a 'Részletes keresés' fül után be lehet rakni egy sajátot... Ehhez a fulek.cfg-ben kell: 

+Sajatful sajatful.txt

A sajatful.txt-be be kell irni a komplett fület. Ehhez segítséget a sajatful.txt.pld fáljban lehet találni.

tlwgen.exe futtatas szükséges utána.

1.48. Gyorskeresés

Ki lehet rakni a könyvtár honlapjára egy 'Keresés a katalógusban' gombot. Egyetlen input mező kell hozzá, az alábbi módon (persze textlib.hu helyett a sajat tlwww gepet kell beirni :-) 

<form action="http://textlib.hu/tlwww" method=GET accept-charset="UTF-8">
<input name="kerd" value=""><BR>
<input type=submit value="Keresés a katalógusban">
</form>
Ez több keresést indít egymás után, az eredményeket egy táblázatban látjuk.

1.49. Elnevezések

Könyvtár, település, fiók: lehet olyan nevet adni neki, ami a TLWWW-ben jelenik meg, a valódi neve helyett. Ott, ahol azt látjuk, hogy 

Könyvtárnév (i): 2 kölcsönözhető, 1 elvihető; [foglalás] (i)
Meg lehet adni plusz információkat is, amik a könyvtárnév fölé vitt egérkurzorral jeleníthetők meg. A szöveg minden ismétlődése külön sor lesz megmutatáskor.

A winkliensben a könyvtár/település/fiók ablak alja felé találjuk: 

TLWWW név: ......
TLWWW info: ......
Ezeket a mezőket kell megfelelően kitölteni.

1.50. Info ikon

A html oldalakon több helyen kis (i) ikonok jelentek meg. Pl. az előbb említett könyvtárnév után. Vagy pl. a foglalás és előjegyzés gombok után. Ezek fölé víve az egeret információkat kapunk. Pont azt, amit az előtte lévő szöveg/gomb fölé menve is kapnánk. Az értelme az az (i) ikonnak, hogy

1.51. Rendezés

Készíthetők rendezési formátumok, amikkel a TLWWW-ben megjelenő halmazokat rendeztethetjük. A rendezési formátum neve kötelezően 'TLWWW:' szöveggek kell kezdődjön.

Ezeket a TLWWW induláskor lekeresi, ezek szerint lehet később a találati halmazokat rendezni.

A 'Részletes keresés' fülön még a keresés előtt meg lehet adni, milyen rendezettséggel akarjuk látni az eredményeket. De a találati listában is bármikor lehet másik rendezést kérni.

Ahhoz, hogy a Részletes fülön legyen Rendezettség mező, a fulek.cfg-be: 

+Rendezes
sort kell beirjunk (lasd fulek.cfp), majd tlwgen.exe futtatas!

A rendezési formátumban van két új mező: 

TLWWW Előtte:  - ezt kell kiírni a rendezési kulcsok előtt
TLWWW Kiemelt: - ennyi rendezési kulcsot kell kiemelni
Ha a Kiemelt mezőt kitöltjük (általában 1-re), akkor a rendezett halmazoknál a rendezés kulcsa külön sorba ki lesz emelve...

1.52. Keresés hatásköre

A Részletes keresés fülön megjelenő 'Keresés hatásköre' mező bővíthető. Kistérségben a települések, fiókos rendszerben a fiókokra is kiterjeszthető. Megadhatók itt raktárak és állományok is.

A fulek.cfg-ben egy sor: 

+KeresesHataskor myhataskor.txt
A fájl pedig ilyen sorokból áll: 
<option value="ah1">Pákolitz István Városi Könyvtár - Paks</option>
 <option value="gx71.2">Községi Könyvtár Bikács</option>
 <option value="gx72">Községi Könyvtár Kajdacs</option>
 <option value="u12432">AP raktár</option>
 <option value="s1135">Felnőtt állomány</option>

1.53. Információ hordozóra keresés

A Részletes keresésbe be lehet rakni Információ hordozó kereső mezőt is. Ez sajnos minden könyvtárban más és más, ezért kell mindenhol külön dolgozni vele.

A fulek.cfg-ben: 

+InfhordozoKereses   myinfhord.txt
a fájlban pl: 
<option selected value="">Minden</option>
 <option value="DVD">DVD-FILM</option>
 <option value="CD">AUDIO-CD</option>
<option value="VHS">Videókazetta</option>

1.54. Plusz keresőmezők

A Részletes keresés fülön plusz keresőmezők adhatók meg. A fulek.cfg: 

+ReszletesKeresesMezok myreszlker.txt
a fáljban: 
</tr><tr>
   <td>Beszerzés ideje:</td>
   <td><SELECT size=1 name="gy" width=60>
   <option value="">Bármikor</option>
   <option value="1 hét">1 héten belül</option>
   <option value="2 hét">2 héten belül</option>
   </select></td>
 </tr><tr>
   <td>Témakör</td>
<td><input type=hidden name=index4 value=szak>
<select name=value4 style="width:275px">
<option value="">Minden</option>
<option value=000--099>0xx - Általános művek</option>
<option value=100--199>1xx - Filozófia, Pszichológia</option>
   </select></td>
</tr><tr> --- tovabbi keresomezok ---</td>

1.55. Mobilos weboldal

Az m.cfg fájlban (fulek.cfg-hez hasonlóan) lehet megadni, milyen elemek legyenek a mobilos oldalon.

A mobil oldalt a xxx.hu/tlwww/m.htm címen lehet elérni, de ha mobil eszközről nézzük a normál kereső oldalt, az automatikusan átírányít ide.

Persze csak akkor, ha ezt a fulek.cfg-ben beállítottuk igy: 

+MobilAtiranyit
Érdemes egy symlinket rakni a /var/www-be, hogy xxx.hu/m.htm cimen is elérhető legyen a mobil oldal.

1.56. QR code

Lehet generálni QR kódot, amit ki lehet rakni pl. plakátra, és azonnal a kereső oldalra lehet vele ugrani. Mobilon egyszerűbb, mint az URL-t bepötyögni :-)

Például itt készíthető QR kód: GOQR.ME

1.57. TCP kommuniukáció

Ha TCP-vel akarunk csatlakozni a TLSRV-hez, akkor /usr/share/tlwww/tlwww.cfg-ben: 

network=tcp
 servertcp=192.168.1.1:11345   (ide a TLSRV IP cime+portja kell)
Ekkor a tlgw3.cfg fajl nem is szamit! Érdemesebb már a TCP-t használni! UDP meg is fog szűnni!

1.58. Többnyelvű TLWWW

Többnyelvű TLWWW használható, ha:

1.59. Egy példa fulek.cfg:

# fulek.cfg - fulek.htm config fajl. 
# fulek.htp + fulek.cfg-bol all ossze a fulek.htm

# Output file - oda kerul, ahol a html oldalak vannak egyebkent is
# Amig csak probaljuk, milyen is lesz:  fulek.htm
# Ha ez legyen a keresooldal, akkor:    homepage.htm vagy index.html
homepage.htm

# Könyvtár neve
Piripócsi Városi Könyvtár
# Konyvtar honlapja (url) - Ide visz majd a [Honlap] gomb
www.piripocskonyvtar.hu

# Reszek beallitasa... 
# Aminek az elejen + jel van, csak az a resz kerul be a fulek.htm-be
# Meg kell adni egy fajlt, amiben a szoveg (html kod) van, amit meg kell 
# jeleniteni.
# Pl.3: Akarunk a keresolap vegere kiirni valamit:
#  +Lapvege ful.lapvege.txt
-Pluszgomb pluszgomb.txt
-Lapeleje  lapeleje.txt
-Lapvege   lapvege.txt

# Gombok beallitasa
# Ujdonsagok: [1het] [2het] ... Az Egyszerusitett keresesben
# A [Chat] gomb a keresooldal tetejen
-ChatGomb
+UjdonsagGomb

# Keresesi opciok beallitasa
# Ha kell Ekonyvtar, akkor a fajlba kell beirni az Interneten mezoben
# keresendo szoveget. Pl: e-kvt
# Informacio hordozo keresesnel egy kis html kodot is kell irni,
# Peldanak lasd: ful.InfhordozoKereses.def.txt
-EkonyvtarKereses myekonyvtar.txt
-InfhordozoKereses myinfhordozo.txt

# Az egyes fulek beallitasa. + vagy - a sor elejen, ha kell/nem kell a ful.
# Nem kotelezo a fajlnev, akkor kell csak, ha le kell cserelni a fulhoz
# tartozo help szoveget (default help szovegek: ful.*.def.txt)
# Pl.1: Kell az ujdonsag ful, de jo a default help szovege
#  +Ujdonsagok 
# Pl.2: Kell a Biografia ful, de mas help szoveggel kellene:
#  +Biografia ful.biografia.txt
+Egyszeru_kereses 
+Reszletes_kereses 
+Ujdonsagok 
+Bongeszes 
+Biografia 
+Tortenet
+MasokKerestek
-Koztaurusz 
-Letetek
+Olvallapot
+Partnerallapot
-Regisztracio 
+Segitseg
# Nyelv valaszto, alapbol nincs
+NyelvValaszto
# Rendezes mezo a Reszletes kereses fulon
+Rendezes

## Angol nyelvi beallitasok
Language eng
homepage.htm
Test Library
www.enkonyvtaram.hu/en
+NyelvValaszto
+Egyszeru_kereses 
+Reszletes_kereses 
+Ujdonsagok 
+Bongeszes 
+Biografia 
-Koztaurusz 
-Letetek
+Olvallapot
-Regisztracio 
+Segitseg
-Pluszgomb pluszgomb.eng.txt
-Lapeleje  lapeleje.eng.txt
-Lapvege   lapvege.eng.txt
-ChatGomb
+UjdonsagGomb

Vissza: Kiegészitő programok TextLib honlap