TextLib üzenetküldő

Újdonságok

A TextLib üzenetküldő egy önállóan telepítendő program, amellyel az olvasókat tájékoztató és felszólító levelek (email, SMS, facebook üzenet) küldését automatizálhatjuk.

A programmal az olvasók jóváhagyásával, a korábban papíron, postai úton küldött értesítéseket elektronikus üzenetekkel helyettesíthetjük. Az üzenet formája lehet email, SMS vagy mindkettő (hamarosan facebook messenger üzenet is). Az email tartalma megegyezik az eddig postán küldött levéllel, SMS-ben csak egy rövid figyelmeztetés megy.

Az üzenetküldő működését éppúgy a Rendszer - Könyvtárunk adatai - Paraméterek táblázatban és altáblázataiban beállított értékek vezérlik, vagyis azok határozzák meg az értesítések számát és gyakoriságát, ahogy a papír alapú értesítésekét is. Egy kiegészítés tartozik ide: ha az üzenetküldő által küldött felszólítások száma eléri a paeaméterrendszerben beállított maximáslis számot, vagyis az utolsó felszólításnál tartunk, és az olvasó erre sem reagál, akkor a rendszer átteszi ezt az értesítést a papíron küldendők közé, függetlenül attól, hogy az olvasó kér-e papíron bármilyen értesítést.

A fentiekből és abból, hogy nem minden olvasó fogad értesítést emailben vagy sms-ben, az következik, hogy az üzenetküldő használata mellett is szükség van rendszeresen áttekinteni a papír alapon küldhető értesítéseket kezelő menüpontokat.

A használat feltételei:

Előnyei:

A program azoknak az olvasóknak küld értesítéseket, akik a TextLib web OPAC felületen saját maguk, vagy akiknek kérésére a könyvtáros a könyvtárosi munkafelületen email vagy sms küldést állított be.

Az olvasószolgálati munkában keletkező üzenetek közül

készült el, a fizetési felszólítás még nem. Ezeken kívül a program képes Végül pedig képes a

1. Telepítés, beállítás, teszt

1.1. Telepités

Linux: A program működésének feltétele a php megléte, ezért elsőként telepítsük a php5 és a php5-cli csomagot. A TextLib V2.1.1641 verzió óta a PHP7 is használható.

Az üzenetküldő telepítője: Debian (.deb) 32/64 bit (http://textlib.hu/debian/dists/V2/main/), Suse (.rpm) (http://textlib.hu/rpm.200/)

Windows: telepítő: itt található (https://textlib.hu/windows/felujito/2.1/)

A tlmsg-<verzio>.exe futtatásával telepíthető a program.

1.2. A TextLib szerver címének beállítása

Linux: Az /usr/share/tlmsg/tlmsg.cfg-ben kell megadni:

network=tcp
servertcp=IP:PORT
Windows: TextLib Üzenetküldő - Hálózati beállítások menüpont, itt lehet a TextLib szerver IP címét megadni.

1.3. Saját adatok megadása a tlmsg.cfg-ben

Linux: /usr/share/tlmsg/ alatt találjuk a tlmsg.cfg-t.

Windows: A TextLib Üzenetküldő - tlmsg.cfg szerkesztése menüpont.

A tlmsg.cfg-t a telepítőkészlet tartalmazza, és a beállításhoz szükséges sorok rövid útmutató kíséretében megtalálhatók benne. A beállításhoz az egyenlőségjel utáni részt kell módosítanunk. A szövegben a sor elején a ";" és a "#" jel a sort a működés szempontjából közömbös megjegyzéssé változtatja.

A program felújítása után létrejön egy tlmsg.cfp nevű állomány, ami tartalmazza a program fejlesztése miatti új beállítási lehetőségekhez szükséges részeket is. Indokolt tehát időről időre ellenőrizni, hogy van-e tlmsg.cfp, és hogy van-e benne olyan szövegrész, amit beállítva az új képességek működővé válnak.

1.4. Beállítás ellenőrzés

A tesztelés idejére állítsuk be a következőt:

sms_sendto=  saját mobilszám vagy email cím
email_sendto= saját email cím

Ez lehet 'Nev <email_cim>' formaban is! Pl.: sms_sendto=TLMSG-SMS <teszt@konyvtarunk.hu>

Ha ezt megadjuk, akkor az email vagy sms az olvasó helyett nekünk jön, és az adatbázisban nem történik meg az adminisztráció, hiszen NEM ment ki igazából az üzenet az olvasónak. Eredményét tekintve olyan, mintha nem is küldtünk volna semmit, így akárhányszor megismételhetjük.

Futtassuk a következőt:

Linux: /usr/share/tlmsg/tl_msg_vfelsz parancsot futtassuk.

Windows: A "Felszólítás visszahozatalra" menüpont futtatása után a "Textlib Üzenetküldő naplójának könyvtára" menüpont megnyitja a napló könyvtárat, amelyből a vfelsz_log.txt dupla kattintással megtekinthető.

Ha ezt az eredményt látjuk, akkor eddig minden rendben:

Email kuldes nincs beallitva a konyvtarban
SMS kuldes nincs beallitva a konyvtarban

1.5. Email/sms beállítása

A winkliensbe rendszergazdaként lépve a Rendszer - Könyvtárunk adatai menüpontban a
--- Használatba vett alrendszerek ---

fejezetcím után pipáljuk ki ezek közül a szükséges funkciókat

1.6. TLWWW beállítás

1.6.1. usersets beállítása

A tlwww.cfg-ben a usersets értékét kell beállítani, hogy email/sms értesítést kérhessen az olvasó. A beállítás eredményeként az olvasó a web OPAC-ba azonosítóval és jelszóval belépve jogosulttá válik az értesítéseket kérni és lemondani.

# usersets - miket allithat az olvaso
# 1=adatmodositas, 2=email, 8=mobilszam, 32:lakcim, 64:levcim
# 512,        /* email kuldest allithatja a user web-en */
# 1024,       /* SMS kuldest allithatja a user web-en */
# 2048,       /* előzetes Email figyelmeztetest allithatja */
# 4096,       /*  előzetes SMS figyelmeztetest allithatja */
# 2048 + 512 + 8 + 2 + 1 = 2571
usersets=2571
Ez a beállítás természetesen csak az email vagy sms küldést befolyásolja, ha az olvasó lemondja, akkor visszaáll a papír alapú küldés.

A tlwww.cfg szerkesztése után a TLWWW-t újra kell indítani!

1.6.2. Hírlevél URL-je

Az újdonság hírlevél hivatkozások listája az új dokumentumokra. Használatához be kell állítani azt az URL-t, amivel részletesen is meg lehet nézni a dokumentumokat. Ez pont ugyanaz, amivel a web OPAC is megmutatja a rekordokat. A tlmsg.cfg-ben állítsuk ezt be. Pl:
tlwwwcgi=http://www.enkonyvtaram.hu/cgi-bin/tlwww.cgi

1.7. TLWWW ellenőrzés

A web OPAC-ba olvasóként belépve, az olvasói állapotot nézve kipróbálhatjuk, hogy tényleg tudjuk-e állítani magunknak az email és sms küldés jelöléseit. Csak akkor sikerülhet, ha van email címünk illetve mobilszámunk megadva.

1.8. Email küldés ellenőrzés

Linux:

Ez a lépés azt ellenőrzi, hogy a linuxban be van-e rendesen állítva az email küldés. A kipróbáláshoz küldjünk egy emailt egy tetszőleges külső email címre. Ha az odaér, akkor érdemes csak továbblépni. Linuxban: (TESZT@MAIL.HU helyere kell a sajat email cim)

cd /usr/share/tlmsg
./tlmail.php -addr TESZT@MAIL.HU -subj tlmsg1 -file tl_msg_vfelsz
Az eredmeny ket egyforma sor kell legyen:
<TESZT@MAIL.HU>:OK
<TESZT@MAIL.HU>:OK
Ez még nem jelenti azt, hogy el is ment a levél. Csak azt, hogy sikerült átadni a szervernek. A levél meg kell érkezzen az adott címre, a tartalma a tl_msg_vfelsz file tartalma lesz. Ha nem érkezik meg a levél, akkor a /var/log/mail.log (vagy exim4/mainlog vagy ???) fájlban root-ként meg kell nézni mi a sikertelen küldés oka.

Windows:

Lásd itt

1.9. Próba futás

Linux:

/usr/share/tlmsg/tl_msg_vfelsz

Windows:

Indítsuk a programot a Start - ... TextLib Üzenetküldő - Felszólítás visszahozatalra (E-mail, SMS) menüpontban, majd a Textlib Üzenetküldő naplójának könyvtára mappában nézzünk bele a vfelsz_log.txt-be.

A futtatás eredménye ilyen kell legyen:

Levéltípus: 2-Felszólítás visszahozatalra, Dátum:2011xxxx
Email 0 találat...
SMS 0 találat...

Ez a normális, mivel üzenetet a rendszer csak olyan kölcsönzések miatt küld, amely kölcsönzések lezajlásának pillanatában már működött az üzenetküldés, ilyen pedig még nincs.

A Régi kölcsönzések beállítása című fejezetben lesz arról szó, hogyan lehet az adatbázisban található összes élő kölcsönzést beállítani az üzenetküldő által is figyelt kölcsönzéssé.

A Minden olvasó beállítása fejezetben van szó arról, hogyan lehet az összes email címmel/mobilszámmal rendelkező olvasónak beállítani az email/sms küldést. De talán célszerűbb ezt az olvasókra hagyni, hogy beállítsák.

1.10. Könyvtár rekord beállítása

Kliensbe belépés rendszergazdaként, majd:

1.11. Változók használhatók

Ahova az aktuális olvasó nevét, vonalkódját, az aktuális dátumot stb. akarjuk írni a levélben, oda változót kell raknunk. Ezt a levél küldésekor tölt ki a TLMSG program. Például:

Kedves ${textlib-user-name} (vonalkód:${textlib-user-vkod})
helyett
Kedves Kiss Béla (vonalkód:23541354)
megy ki a levélben

Ezek a változók vannak:

Mindenhol használható:
  ${textlib-user-name}       - olvasó neve
  ${textlib-user-email}      - olvasó email címe
  ${textlib-user-dref}       - olvasó rekord azonosítója (pl. ac43123)
  ${textlib-user-vkod}       - olvasó vonalkódja
  ${textlib-user-stat-url}   - olvasoi állapot oldalra mutató URL
  ${textlib-current-date}    - az aktuális dátum
Újdonság hírlevél template fájlban:
  ${textlib-content-text}    - az újdonság lista sima szöveges levélbe
  ${textlib-content-html}    - újdonság lista HTML levélbe, <LI> elemekből áll!
  ${textlib-gyarapodas-text} - melyik időszakra vonatkozik, pl.: '2 hónap'
  ${textlib-gyarapodas}      - időszak - tlwww.cgi?gy= kereséshez, pl. '34nap'
Mindkét hírlevél template fájlban:
  ${textlib-lemond-url}      - hírlevél lemondáshoz URL
  ${textlib-tlwwwcgi}        - tlwww.cgi URL-je

Példa: ilyen lehet az újdonságok hírlevélben: Az újdonságok kereséséhez <a href="${textlib-tlwwwcgi}?gy=${textlib-gyarapodas}">klikk ide</A>

Használhatók a levelek témájának megadásánál, és a hírlevél template fájlokban is. Mindkettőről később talál leírást.

A változóknak van angol verziója is, ahol van ennek értelme, Pl:

${textlib-gyarapodas-text-eng}

1.12. Levelek témája (subject) beállítható

Minden levéltípusra megadható, hogy mi legyen a kiküldött levelek támája:

vfelsz_subject=Felszólítás visszahozatalra - ${textlib-user-vkod} azonosító
wfelsz_subject=Előzetes figyelmeztetés a könyvtártól
efelsz_subject=Figyelmeztetés ${textlib-user-name} részére
ujdok_subject=Az XXXX könyvtár friss beszerzései
kvthir_subject=XXX könyvtár újdonságai - ${textlib-current-date} napon

1.13. Fix szövegek a levelek végén

Az email-ek végére lehet rakni plusz szövegeket.

A szövegeket fájlba kell beleírni, a fájlok nevét pedig a tlmsg.cfg-ben lehet megadni.

Minden levéltípushoz más-más fájlt tartozhat. Pl:

vfelsz_vege=/usr/share/tlmsg/felszolitas_visszahozatalra_vege.txt
wfelsz_vege=/usr/share/tlmsg/hatarido_elotti_figyelmeztetes_vege.txt
efelsz_vege=/usr/share/tlmsg/ertesites_elvihetorol_vege.txt
ujdok_vege=/usr/share/tlmsg/ujdonsagok_hirlevel_vege.txt

1.14. Angol nyelvű levelek

Minden levéltípus: Ha az olvasóban be van állítva, hogy angol nyelvű leveleket szeretne (USER_NYELV mező, Regisztráció ablakban a könyvtáros, web-es felületen az olvasó saját maga állíthatja) A tlmsg.cfg-ben megadható mindennek az angol verzója, pl.:

efelsz_subject_eng=Notification about books ready for pick-up
wfelsz_vege_end=/usr/share/tlmsg/hatarido_elotti_figyelmeztetes_vege_eng.txt

2. Levéltípus: Felszólitás visszahozatalra

A lejárt határidejű kölcsönzések miatti felszólítások. Ezeknek az olvasóknak küld email/sms üzenetet. Azon kölcsönzésekről, amikről email vagy SMS ment, nem megy ki később postai levél. Kivéve: utolsó figyelmeztetés.

Logfájl: vfelsz.log

Naponta egyszer érdemes futtatni. Ha emailt és SMS-t is küldünk, azt csak egyszerre lehet küldeni, egy futás keretében!

Ha SMS-t is küldünk, nem csak email-t, akkor nem célszerű hajnalban futtatni, az olvasók talán nem örülnek, ha az SMS-re ébrednek :-)

2.1.1. Rendszeres futás idejének beállítása:

Linux: /etc/cron.d/tlmsg_vfelsz

Windows: "Ütemezett feladatok beállítása" menüpont.

Egyszerre lehet csak küldeni az email-eket az sms-eket!

2.1.2. Azonnali elküldés (email és sms is):

Linux: /usr/share/tlmsg/tl_msg_vfelsz

Windows: "Fizetési felszólítás" menüpont.

2.1.3. Azonnali elküldés (csak email):

Linux: /usr/share/tlmsg/tl_msg_vfelsz email

2.1.4. Azonnali elküldés (csak sms):

Linux: /usr/share/tlmsg/tl_msg_vfelsz sms

3. Levéltípus: Előzetes figyelmeztetés

Kölcsönzések határidejének lejárata előtti értesítés. Az SMS a határidő előtti napon megy ki, email-nél pedig beállítható (a könyvtár paraméterei közt), hogy hány nappal a határidő előtt menjen. Érdemes ezt 1-nél nagyobbra venni. Amelyik olvasó kérte mindkét értesítést, és az email hatására visszahozza a könyvet, akkor SMS-t már nem is fog kapni. Ilyen tipusú üzenetet postai levélben sosem küldünk.

Beállítás: tlmsg.cfg-ben megadható a küldött levél témája:

Logfájl: wfelsz.log

Minden nap érdemes futtatni. Ennél a funkciónál megoldható, hogy az email és az SMS küldés két külön futással menjen. Lehet pl. email-t reggel küldeni, SMS-t pedig csak este. Igy nem kap SMS-t az, aki pont ezen a napon amugy is visszahozza a konyvet.

3.1.1. Rendszeres futás idejének beállítása:

Linux: /etc/cron.d/tlmsg_wfelsz

Windows: "Ütemezett feladatok beállítása" menüpont. Itt külön lehet állítani az email és az sms küldés idejét.

3.1.2. Azonnali elküldés email+sms:

Linux: /usr/share/tlmsg/tl_msg_wfelsz

Windows: "Előzetes figyelmeztetés ..." menüpontok valamelyike.

3.1.3. Azonnali elküldés, csak email:

Linux: /usr/share/tlmsg/tl_msg_wfelsz email

4. Levéltípus: Értesítés elvihetőkről

Az előjegyzés vagy foglalás miatt félretett könyvekről szóló értesítés. Ha kapott az olvasó email vagy sms értesítést, akkor levelet nem fog már kapni.

Beállítás: tlmsg.cfg-ben megadható a kimenő levél témája:

Logfájl: efelsz.log

Minden nap érdemes futtatni. Ennél a funkciónál megoldható, hogy az email és az SMS küldés két külön futással menjen. Lehet pl. email-t akár 5 percenként küldeni, SMS-t pl. óránként (vagy csak naponta egyszer - zárás után).

4.1.1. Rendszeres futás idejének beállítása:

Linux: /etc/cron.d/tlmsg_efelsz

Windows: "Ütemezett feladatok beállítása" menüpont. Itt külön lehet állítani az email és az sms küldés idejét.

4.1.2. Azonnali elküldés, email+sms:

Linux: /usr/share/tlmsg/tl_msg_efelsz

Windows: "Értesítés elvihetőkről ..." menüpontok valamelyike.

4.1.3. Azonnali elküldés, csak email:

Linux: /usr/share/tlmsg/tl_msg_efelsz email

5. Levéltípus: Újdonságok hírlevél

A könyvtárban újabban beszerzett dokumentumok listája az olvasó tájékoztatására. Ahol érkeztetéssel viszik be a példányokat, ott simán használható.

Ahol nem így történik, ott szükség van a g-feldolg.exe (linux) ill. w-feldolg.exe (windows) programra. Ezt minden hajnalban a mentés előtt érdemes automatikusan futtatni. Ez kitölti a kötet rekordok FELDOLGOZVA mezőjét, ami alapján az újdonságok keresése megy.

Multipart levelek mennek, html és text részből állnak. A html részben a könyv címek egyúttal link-ek, amik az online katalógusba mutatnak...

Logfájl: ujdok.log

Hetente - Kéthetente - havonta érdemes futtatni. Ilyenkor automatikusan az előző futás óta beszerzett dokumentumokról küld értesítést. Érdemes kora reggel futtatni, mivel kiküldi az aznap beszerzetteket is. A következő futásnál az előző futás dátumával kezd, vagyis az aznapiak kétszer szerepelnek, ha pl. este van a kiküldés.

5.1.1. Rendszeres futás idejének beállítása:

Linux: /etc/cron.d/tlmsg_ujdok

Windows: "Ütemezett feladatok beállítása" menüpont.

SMS-ben persze nem lehet ilyen levelet küldeni :-)

5.1.2. Azonnali elküldés, email:

Linux: /usr/share/tlmsg/tl_msg_ujdok

Windows: "Újdonságok hírlevél (email)" menüpont.

Paraméterként megadható, hogy az elmúlt hány napnak az újdonságait kell lekeresni. Erre az --elozo paraméter szolgál. pl.:

--elozo 20nap
--elozo 3het
--elozo 2honap
Az utolsó hírlevél kiküldés óta beérkezett újdonságok pedig:
--ujdonsag

Paraméter, hogy a lejárt beiratkozású olvasók mennyi ideig kapják még a hírlevelet. Default: 3hónap; Min: 0nap; Max: 10év

--lejart 90nap
--lejart 44het
--lejart 9honap
--lejart 2ev
Paraméter, hogy hány újdonság legyen legalább, hogy kimenjen a hírlevél:
--mindb 10

Az újdonságok hírlevél estében az egész levelet le lehet cserélni. Ehhez ún. template fájlt kell megadni. Egyet a html levélhez, egyet a text-hez.

ujdok_text=/usr/share/tlmsg/ujdok.txt
ujdok_html=/usr/share/tlmsg/ujdok.html

Van két mintafájl a /usr/share/tlmsg/ alatt, magukért beszélnek:

ujdok.txt.pld - {www.textlib.hu/txt/ujdok.txt.txt=megnézhető itt}
ujdok.htm.pld - {www.textlib.hu/txt/ujdok.htm.txt=megnézhető itt}

6. Levéltípus: Könyvtári hírlevél

Kétféleképp lehet könyvtári hírlevelet készíteni:

A tlwww.cfg-ben megadott parameterektől függ, melyik készül. Esetleg mindkettő.

Logfájl: kvthir.log

6.1. Ha körlevél készítő programot (MS Word, LibreOffice stb.) használunk

TextLibbel csak egy adatfájlt kell előállítani, amit oda lehet adni a körlevélkészítőnek. A körlevélben felhasználhatók az olvasó adatai: név, azonosító stb. Az adatfájl elkészítéséhez NEM kell az TLMSG program.

Teendő Winkliensben olvasószolgálatos könyvtárosként belépve:

DREF,NEV,LEANYNEV,EMAIL,ANYJANEVE,MOBIL,NEME,IRANYITOSZAM,VAROS,CIM,SZULIDO,FOGLALKOZAS,SZIGSZAM,OJEGYLEJARATA,KVT_HIR,UJ_HIR
"ac856","Kiss Imre","","emil@valami.hu","Németh Anna","301111111","Férfi","","Szeged","Széchenyi u. 6.","","Informatikus","111111CA","","",""
"ac918","Kiss Anna","","emil@masikk.hu","Kisss Ilona","202222222","Nő","","Paks","Kelemen u. 30.","","","222222IA","","",""

6.2. TLMSG-vel is küldhetjük a hírlevelet

Egyszerűbb, de kevésbé testre szabható. Minden olvasó kb. ugyanazt a szöveget kapja. A tlmsg.cfg-ben megadjuk, milyen fájlban található a hírlevél. A könyvtári hírlevél küldést beállítjuk, hogy küldjön naponta. Ha van fájl, akkor küld, ha nincs, akkor nem. Küldéskor tehát csak annyi a feladat, hogy a txt/html fájlokat oda kell másolni a helyükre.

A tlmsg.cfg-ben lehet megadni a kiküldendő szöveget tartalmazó fájlt, és a küldendő levél témáját:

kvthir_text=/home/peter/kvthir/level.txt
 kvthir_html=/home/peter/kvthir/level.html
 kvthir_attachment=/home/peter/kvthir/level.pdf

Paraméter, hogy a lejárt beiratkozású olvasók mennyi ideig kapják még a hírlevelet. Default: 3hónap; Min: 0nap; Max: 10év

--lejart 90nap
 --lejart 44het
 --lejart 9honap
 --lejart 2ev

6.2.1. Rendszeres futás idejének beállítása:

Linux: /etc/cron.d/tlmsg_kvthir

Windows: "Ütemezett feladatok beállítása" menüpont.

SMS-ben persze nem lehet ilyen levelet küldeni :-)

6.2.2. Azonnali elküldés, email:

Linux: /usr/share/tlmsg/tl_msg_kvthir

Windows: "Könyvtári hírlevél (email)" menüpont.

A hírlevél küldő programot rendszeresen (naponta vagy akár óránként) futtassuk. Annyi csak a dolgunk, hogy ha akarunk kiküldeni hírlevelet, hogy a kvthir_text= parameterben megadott nevu fajlt hozzuk letre. A következő futáskor a hírlevelek kimennek, a fájl pedig át lesz nevezve.

7. Használat élesben

tlmsg.cfg-ben kitörlendő sorok:

email_sendto=...
sms_sendto=...
Ha nyomon akarjuk még követni, milyen üzenetek mennek ki, arra az
email_bcc=emailcim
sms_bcc=emailcim_vagy_mobilszam
használható. Ekkor kimegy az üzenet az olvasó valódi címére és az itt megadott címre is.

1640 verzió: Ha van jótálló, és neki is menjen email:

jotallo_cc=1

8. Statisztika

Készülnek statisztika fájlok is. Pl: efelsz.stat.txt

Ebben minden sor egy napon kiküldött levelek számát mutatja. pl:

2012-03-14|email|4|6|sms|3|5
Jelentése:
dátum|email|hány olvasónak|hány kölcsönzésről|sms|hány olvasó|hány kölcs.

9. SMS küldés

SMS küldésre SMS gateway-ek használhatók. Mi több lehetőséget végig próbáltunk. A SeeMe cég rendszerét ajánljuk: SeeMe SMS gateway (https://seeme.hu/tomeges-sms-gateway)

Előnye, hogy nem kell semmilyen hadvert beszerezni, a SMS-eket a SeeMe rendszere küldi ki. Az SMS-ek ára is kisebb, mint pl. egy normál mobiltelefon előfizetésnél.

Szerződést kell kötni a SeeMe-vel. Ezután adnak egy azonosítót és jelszót, azt kell a cfg-ben beállítani, és már mehetnek is az SMS-ek. Nem csak TextLibből, de akár egy WEB oldalról is lehet így sms-t küldeni.

Érdemes beállítani a SeeMe honlapon a 'karakter csere' opciót. Így nem lesz esetleg egy SMS két részletben elküldve (Utf8 ékezetes betűk / GSM karakterkészlet különbözőség miatt) !

.H3. Beállítás - új módszer: seeme-key

Ez csak a V2.1.1632 TextLib verziótól kezdve használható.

A SeeMe honlapon API kulcsot kell létrehozni, azt elmenteni. A lenti szövegben az <API-KEY> helyére bemásolni.

Linux: /usr/share/tlmsg/tlmsg.cfg-ben:

sms_prog=/usr/share/tlmsg/tlsms.php
 sms_gateway=seeme-key
 seeme_key=<API-KEY>
 # Reszletes log-ot gyart ide: /tmp/tlsms.teszt.log
 sms_teszt=yes
Windows: 'TextLib üzenetküldő / tlmsg.cfg szerkesztése' menüpont

9.1.1. Beállítás - régi módszer:

Linux: /usr/share/tlmsg/tlmsg.cfg-ben:

sms_prog=/usr/share/tlmsg/tlsms.php
 sms_gateway=seeme
 seeme_user=xxx
 seeme_password=xxx
 # Reszletes log-ot gyart ide: /tmp/tlsms.teszt.log
 sms_teszt=yes
 # A kikuldott sms-ek szovege menjen el ide is, email-ben.
 sms_bcc=tesztuser@konyvtar.hu
 # teszthez: minden sms ide menjen, ne az olvasonak
 sms_sendto=tesztuser@konyvtar.hu

Windows: 'TextLib üzenetküldő / tlmsg.cfg szerkesztése' menüpont

Meg lehet adni egy ún. callback URL-t a seeme-nek. SMS küldés esetén ez hívódik meg a küldés adataival (pl. SMS központ fogadta az sms-t, sikeres a küldés, stb).

Linux: erre a célra keszitettunk egy seeme-callback.php scriptet. Ezt át kell másolni pl. egy /var/www/seeme/ könyvtárba.

Ebbe kell rakni a seeme-callback.cfg fajlt is. Ebben kell beallitani, hogy kell-e es kinek emailt küldeni a visszajelzések esetén. Az email-től függetlenül a /var/log/tlmsg/tlsms.log fájlban gyűlni fognak a bejegyzések, hogy kinek mikor ment/nem ment SMS.

A SeeMe-nek a seeme-callback.php URL-jet kell megadni. pl: http://www.xxxkonyvtar.hu/seeme/seeme-callback.php

Windows: Még nincs előre elkészített callback. Ha van elérhető linuxos gép, azon lehet használni a seeme-callback.php-t.

Ilyen levelek várhatók, ha kerünk email küldést:

Subject: seeme callback:362056xxxxxx
Date: Wed, 26 Oct 2011 11:23:02 +0200 (CEST)
TLSMS-ac12321-36205xxxxxx - 36205xxxxxx - 4 - 2011-10-26 11:23:02 - 16.00 Ft - Távoli SMSC fogadta
Subject: seeme callback:36205xxxxxx
Date: Wed, 26 Oct 2011 11:25:02 +0200 (CEST)
TLSMS-ac12321-36205xxxxxx - 36205xxxxxx - 6 - 2011-10-26 11:25:11 - 16.00 Ft - Kézbesítve

Az egyes adatok a levélben:

Megadható egy azonosító, ami minden SMS elejére bekerül. Ebből tudhatja az olvasó, hogy melyik könyvtárból kapta az SMS-t. Ha esetleg több könyvtárba be van iratkozva, ez nem mindig tudható :-) tmlsg.cfg például a vmmk könyvtárban:

sms_azon=VMMK  
Ekkor a kiküldött SMS tartalma:
VMMK:kedves olvasónk...

Elvileg lecserélhető az SMS küldő programunk, ha valaki saját megoldást akar csinálni. Az sms_prog= sort kell lecserélni. És megírni a megfelelő sms küldő scriptet. A VOIP szolgáltatóknál általában lehet olcsón SMS-t is küldeni! De azért előbb beszéljen velünk :-)

10. Postai levelek fájlba nyomtatása

A postán elküldendő leveleket is lehet kezelni a TLMSG-vel. Persze nem megy el a postára, feladni őket, de kinyomtatja a tartalmat fájlba. Aki pl. szerkeszteni akar a levélen valamilyen okból, az a fájlban ezt könnyen megteheti.

Azt is meg lehet tenni, hogy a levél feldolgozó programot lecseréljük. tlmsg.cfg-ben:

snail_prog=/home/bela/sajat-level-feldolgozom.php
A default ez:
snail_prog=/usr/share/tlmsg/tllevel.php

Azt, hogy milyen paramétereket kap a program, ebben lehet megnézni.

Ha pl. nem a /tmp-be akarjuk a leveleket, adhatunk parametert:

snail_prog=/usr/share/tlmsg/tllevel.php -outdir /home/pisti/out/

A postai leveleket a '-media 4' paraméterrel lehet megkapni:

/usr/share/tlmsg/tl_msg_vfelsz -media 4
Minden level kulon fájlba kerül a /tmp/ben, pl.:
tllevel.ac1217.160217-095522.Call_u.txt

11. Hibakeresés

Előfordul, hogy olyannak megy ki email, akinek nem kellene. Ilyenkor mindig keresni kell a log fájlokban, hogy mikor milyen címekre mentek ki levelek. Ezt teszi könnyebbé az email-keres.

Erdemes root-kent futtatni, a linux log-okban csak akkor tud keresni. Kulonben csak a tlmsg logokat nezi... Hasznalat:

/usr/share/tlmsg/email-keres emailcim
Ha van jogunk hozza, hasznalhato a sudo, hogy root-kent fusson a kereses:
sudo /usr/share/tlmsg/email-keres emailcim

12. Működés

Az előzetes figyelmeztetés és a felszólítás visszahozatalra üzenetek a kölcsönzés rekordokból dolgoznak. a kölcsönzéskor beállítódik néhány dátum mező, amikre az összes többi funkció épül:

HATARIDO - határidő. Eddig kell visszahozni. Mai nap + XX utáni első munkanap XX = Kölcsönzés időtartama (paraméter)

KOV_EWARN - következő email előzetes figyelmeztetés Határidő előtt XX nappal, default: 2 XX = Előtte figyelmeztet (paraméter)

KOV_SWARN - következő SMS előzetes figyelmeztetés Mindig a határidő előtti nap

KOV_EFELSZ - követező email/sms felszólítás visszahozatalra Határidő utáni XX. nap utáni első munkanap XX = Türelmi idő/email (paraméter)

KOV_FELSZOLITAS - következő postai felszólítás visszahozatalra. Határidő utáni XX.nap utáni első munkanap. Ha ugyanarra a napra esne, mint KOV_EFELSZ, akkor +1 nap. XX = Türelmi idő/posta (paraméter)

Előzetes figyelmeztetés működése - email:

Előzetes figyelmeztetés működése - sms:

Felszólítás visszahozatalra:

13. Minden olvasó beállítása

Ha GDPR szempontból és a könyvtár érdekének is megfelelő, akkor beállíthatjuk, hogy minden olvasó kapjon emailt vagy sms-t, aki korábban megadta az email címét vagy a telefonszámát, valószínűleg épp ehhez a küldéshez hozzájárulva. A TextLibbe rendszergazdaként lépve keressük meg az összes olvasót, akinek email címe vagy telefonszáma van:

A következő a mezőcsere, amellyel egy műveletben az összes olvasó űrlapján beállíthatjuk, hogy

Az egyes beállításokhoz tartozó megfelelő mezők az alábbiak, ezeket kell a mezőcsere ablakában a Mezőnév mezőben kiválasztani:

A többi beállítás a mezőcsere ablakban pedig azonos, bármit is állítunk be:

14. Régi kölcsönzések beállítása

A régi kölcsönzésekbe egy programmal kitölthetjük azokat a mezőket, amelyek létén alapszik az üzenetküldő működése. Így az üzenetküldő azonnal képessé válik előzetes figyelmeztetések és felszólítások küldésére. A program futtatása nem kötelező, de ajánlott.

Ha nem futtatjuk, akkor az üzenetküldő leghamarabb akkor küld értesítéseket, amikor az üzembeállítását követően lezajló kölcsönzések eljutnak a megfelelő fázisba. Ez esetleg zavaró lehet annak az olvasónak, aki beállítja, hogy kér üzeneteket, de pár hétig mégsem kap, pedig közben járnak le kölcsönzései.

Egyszer kell csak futtatni, a tlmsg használatbavételekor.

Letölthető a program innen:

Linux: http://z1.fszek.hu/y/prog/g-xvfelsz.exe

A /usr/share/tlmsg/ könyvtárba rakandó, innen kell futtatni: /usr/share/tlmsg/g-xvfelsz.exe

Windows: http://z1.fszek.hu/y/prog/w-xvfelsz.exe

A TextLib Szerver Parancssor menüpont indítása után, az aktuális könyvtárba kell bemásolni, majd futtatni is a TextLib szerver program leállítása után: w-xvfelsz.exe

Ez a program minden kölcsönzés rekordban kitölti azokat a mezőket, amik a régi kölcsönzésekben indokoltan kitölthetők.

Vissza: Kiegészitő programok TextLib honlap