TextLib-Msg

Levelek kiváltása elektronikus üzenet küldésével.
Az elektromikus üzenet: email/sms/mindkettő.
Az email tartalma megegyezik az eddig postán küldött levéllel,
SMS-ben csak egy rövid figyelmeztetés megy.

Értelme: hamarabb és olcsóbban (email-nél ingyen) kapja meg az olvasó az üzeneket, mint postai úton.

Használat feltételei: - TextLib és TLWWW 2.00.02 vagy újabb verzió használata - a könyvtár megvette a megfelelő opciót - a könyvtár rekordban be van állítva a funkciók használata

Azok az olvasók, akiknek be van állítva (könyvtáros által vagy TLWWW felületen az olvasó maga állította be) az Email/sms küldés, a különböző levelek helyett emailt és/vagy SMS-t fog kapni.

Jelenleg a felszólítás visszahozatalra (vfelsz) és az előzetes figyelmeztetés (wfelsz) készült, más levelek is lesznek (pl. fizetési felszólítás).

Telepítés, kezdeti tesztek ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. telepités Linux: textlib-msg csomag http://www.infoker.hu/debian/dists/V2/main/binary-i386/ Előtte telepíteni kell a php5, php5-cli csomagokat. Windows: tlmsg-<verzio>.exe futtatásával telepíthető a program.

2. TextLib szerver címének beállítása Linux: /usr/share/tlmsg/tlmsg.cfg-ben kell megadni: network=tcp servertcp=IP:PORT Windows: "Hálózati beállítások" menüpont, itt lehet a TextLib szerver IP címét megadni.

3. tlmsg.cfg-be beirni sajat adatokat Linux: /usr/share/tlmsg/ alatt találjuk a tlmsg.cfg-t. Windows: A "tlmsg.cfg szerkesztése" menüpont

- TextLib adatbázisba belépéshez kell egy dolgozó azonosító+jelszó. user=azon password=jelszo

- Email küldéshez meg kell adni, milyen címről mennek ki a levelek. Ha valaki esetleg válaszol a levélre, akkor azt célszerű megkapni. mail_from=info@konyvtar.hu from_name=Konyvtar neve Ha a fiókok leveleit saját email címükről akarjuk küldeni, a fentiek mellett ez is (igen, szo szerint a 'record' szoveget kell odairni!) mail_from.fiok=record from_name.fiok=record Akkor a FIOK rekord EMAIL mezőjéből veszi az email címet. És a feladó nevét is. Kistérségben ugyanez településekkel: mail_from.telepules=record from_name.telepules=record De ha egy-egy fiók/településre külön email címet kell megadni, lehet. A fiók/település rekordazonosítóját kell használni (pl. az1234): mail_from.az1234=kivetelesfiok@konyvtar.hu from_name.az1234=Kiveteles-fiok-neve

- Futási értesítő beállítása Linux: A cron futtatja az ütemezett feladatokat, az intézi, hogy a programok kimenetét megkapjuk email-ben. Windows: Be kell állítani, milyen email címről milyen email címre menjen értesítés a futásról. notify_name=TLMSG_eredmeny notify_from=honnan@konyvtar.hu notify_mail=hova@konyvtar.hu

- SMTP szerver beállítása Linux: Az email küldést a PHP intézi, ezért nem kell beállítani Windows: "w-tlsend.ini szerkesztése" menüpont után lehet az SMTP szerver adatait megadni. Részleteket lásd lejjeb... Alternatív megoldásként ha az Internet Information Server fel van telepítve és használja a `pickup directory'-t, akkor a "tlmsg.cfg szerkesztése" parancsikon indítása után a küldő program bállítását az alábbiak szerint meg kell változtatni: email_prog=w-tlsend.exe -email -outdir c:\inetpub\mailroot\pickup ahol c:\inetpub\mailroot\pickup az IIS pickup könyvtára. Amennyiben az elérési út szóközt is tartalmaz, akkor az elérési utat idézőjelek (") közé kell tenni. A levél küldése ez esetben akkor sikeres, ha a w-tlsend.exe a megadott könyvtárba létre tudta hozni az e-mail-t tartalmazó fájlt. Ez a beállítás jelenleg (1501) csak az -email opcióra vonatkozik, az sms-ekről küldött teszt e-mailek a w-tlsend.ini-ben beállított SMTP szerveren keresztül kerülnek elküldésre. Ez a működés a közeljövőben változni fog.

- Teszteleskor mindenkepp adjunk meg sms_sendto= (itt lehet sajat mobilszam vagy emailcim is) email_sendto= (sajat mailcim) hogy semmikepp ne az olvasonak menjen uzenet! Pl.: sms_sendto=teszt@xxx.hu email_sendto=teszt@xxx.hu Ha ezt megadjuk, akkor az email/sms nekünk jön, de az adatbázisban nem történik meg az adminisztráció, hiszen NEM ment ki igazából az üzenet az olvasónak :-)

4. Verzió/beállítás ellenőrzés 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 látjuk: Régi az adatbázis szerkezet! Akkor fel kell ujitani tlsrv-t és tlwww-t is! És csináljuk meg újra ezt a futtatást.

Ha futtatáskor ezt látjuk, akkor minden rendben: Email kuldes nincs beallitva a konyvtarban SMS kuldes nincs beallitva a konyvtarban

5. Email/sms beállítása Kliensbe belépés rendszergazdaként. Rendszer/Kvt.adatai menüpontban ebben a részben: --- Használatba vett alrendszerek -- A szükséges funkciókat kipipálni: [Email küldés] [SMS küldés] [Újdonságok hírlevél] [Könyvtári hírlevél]

6. TLWWW beállítás 6/1. tlwww.cfg-ben a usersets= beállítani, hogy email/sms értesítést kérhessen az olvasó. # 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

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

6/2. Az újdonság hírlevél használatához be kell állítani az URL-t, amivel meg lehet nézni a dokumentumokat. Ez pont ugyanaz, amivel a TLWWW is megmutatja a rekordokat. A tlmsg.cfg-ben állítsuk ezt be. Pl: tlwwwcgi=http://www.enkonyvtaram.hu/cgi-bin/tlwww.cgi

7. TLWWW ellenőrzés TLWWW-be olvasóként belépni, olvasó állapotot megnézni, kipróbálni, tényleg tudja-e az olvasó állítani magának, hogy kapjon emailt/sms-t. Persze csak kell akkor tudja, ha van email címe ill. mobilszáma megadva.

8. Email küldés ellenőrzés A legtöbb helyen azért nem ment eddig az email küldés, mert a linuxban nem volt az email rendesen beállítva. Ezért érdemes először azt kipróbálni. Kell küldeni emailt egy 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> <TESZT@MAIL.HU> 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. Tartalma a tl_msg_vfelsz file tartalma. Ha nem erkezik meg a level, akkor a /var/log/mail.log (vagy exim4/mainlog vagy ???) fajlban root-kent meg kell nezni, mi a sikertelen küldés oka.

9. Próba futás Linux: /usr/share/tlmsg/tl_msg_vfelsz Windows: "Felszólítás visszahozatalra" menüpont. Majd a "Textlib Üzenetküldő naplójának könyvtára", itt pedig a vfelsz_log.txt.

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 nincs még egy kölcsönzés sem, ami miatt elektronikusan kellene felszólitani. Lásd lentebb: 'Régi kölcsönzések beállítása'

Minden olvasó beállítása ~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Ha minden olvasóra be kell állítani, hogy kapjon email-t vagy sms-t, akkor le kell keresni az összes olvasót, és MCSERE-vel le kell cserélni a megfelelő mezőt. Az mcsere beállítások a következők:

Mindegyik esetben: Mit: üresen kell hagyni! Mire: 1

Kapjon felszólítást email-ben: Rekord tipus: 44 Mező sorszám: 96

Kapjon SMS felszólítást: Rekord tipus: 44 Mező sorszám: 97

Kapjon határidő előtti email-t: Rekord tipus: 44 Mező sorszám: 98

Kapjon határidő előtti SMS-t: Rekord tipus: 44 Mező sorszám: 99

Persze csak azok az olvasók kapnak valójában, akiknek tudjuk az email címét / mobil számát.

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

Nem kötelező, de ajánlott. Egyszer kell csak futtatni, a tlmsg használatba vételekor :-)

Mivel a régi kölcsönzésekben nincs beállítva a KOV_EFELSZ mező (mert régebben ilyen mező nem is volt) - ezért ezen kölcsönzések miatt nem képződik email/sms felszólítás. A KOV_EWARN és KOV_SWARN mezők sem voltak régebben. Ezek a határidő előtti email/sms figyelmteztetést intézik.

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, innen kell futtatni is: w-xvfelsz.exe

A program futtatása előtt a TextLib szervert le kell állítani!

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

KOV_EFELSZ mező: következő elektronikus felszólítás dátuma. A határidő utáni napra állítja a felszólítás dátumát.

KOV_EWARN, KOV_SWARN: következő előzetes figyelmeztetés dátuma A határidő előtti napra állítja az sms-t, azelőtti napra az emailt.

Ha a programot nem futtatjuk, akkor csak az újabb kölcsönzésekbe kerülnek be az új mezők, csak azok miatt mennek majd elektronikus üzenetek. Ez esetleg zavaró lehet az olvasónak. Beállítja, hogy kér üzeneteket, de pár hétig mégse kap... Pedig közben járnak le kölcsönzései...

UJ! ha rossz dátumok vannak a KOV_xxx mezőkben, azokat is kijavítja.

Levéltipus: 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 postai levél. Kivéve: utolsó figyelmeztetés.

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 :-)

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!

Azonnali elküldés (email és sms is): Linux: /usr/share/tlmsg/tl_msg_vfelsz Windows: "Fizetési felszólítás" menüpont.

Azonnali elküldés (csak email): Linux: /usr/share/tlmsg/tl_msg_vfelsz email

Beállítás: tlmsg.cfg-ben: vfelsz_subject=Felszólítás visszahozatalra - ${textlib-user-vkod} azonosító

Logfájl: vfelsz.log

Levéltipus: 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.

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.

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.

Azonnali elküldés, email/sms/mindkettő: Linux: /usr/share/tlmsg/tl_msg_wfelsz email /usr/share/tlmsg/tl_msg_wfelsz sms /usr/share/tlmsg/tl_msg_wfelsz Windows: "Előzetes figyelmeztetés ..." menüpontok valamelyike.

Beállítás: tlmsg.cfg-ben: wfelsz_subject=Előzetes figyelmeztetés a könyvtártól

Logfájl: wfelsz.log

Levéltipus: É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.

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).

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.

Azonnali elküldés, email/sms/mindkettő: Linux: /usr/share/tlmsg/tl_msg_efelsz email /usr/share/tlmsg/tl_msg_efelsz sms /usr/share/tlmsg/tl_msg_efelsz Windows: "Értesítés elvihetőkről ..." menüpontok valamelyike.

Beállítás: tlmsg.cfg-ben: efelsz_subject=Figyelmeztetés ${textlib-user-name} részére

Logfájl: efelsz.log

Levéltipus: Ú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...

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.

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 :-)

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

Beállítás: tlmsg.cfg-ben: ujdok_subject=Ez az XXXX könyvtár hírlevele

Minta fájlokban használható: ${textlib-content-html} - az ujdonsag lista. <LI> elemekbol all! ${textlib-gyarapodas-text} - melyik időszakra vonatkozik ${textlib-gyarapodas} - időszak - kereséshez, pl. '34nap' ${textlib-tlwwwcgi} - tlwww.cgi URL-je ${textlib-lemond-url} - lemondáshoz URL <a href="${textlib-tlwwwcgi}gy=${textlib-gyarapodas}">xx</A> - keresés

Logfájl: ujdok.log

Levéltipus: Könyvtári hírlevél ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Kétféleképp lehet könyvtári hírlevelet készíteni: 1. Körlevél készítő program - adatfájllal 2. TLMSG körlevél küldés

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

1. Ha körlevél készítő programot (M$ Word, LibreOffice stb) használunk, TextLibbel csak egy adatfájlt kell előállítani, amit oda lehet adni. 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): - Egyéb/Nyomtató kezelés/formátum váltás. - Válasszuk a 'Rendszer rekordok nyomtatása...InfoKer" formátumot. - Keresés/Olv.szolg/Olvasó keresés menüpont - [Kvt.hirlevel+email] gomb - lekeresi az összes olvasót, aki kért hírlevelet, és van email címe is. - Nyomtassuk ki fájlba az olvasókat. Ez lesz az adatfájl körlevélhez. Az adatfájl formátuma ilyen: 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","","",""

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.

tlmsg.cfg-ben lehet megadni a kiküldendő szöveget tartalmazó fájlt: kvthir_subject=Az XXX könyvtár hírlevele kvthir_text=/home/peter/kvthir/level.txt kvthir_html=/home/peter/kvthir/level.html kvthir_attachment=/home/peter/kvthir/level.pdf - text es html közül legalább az egyiket meg kell adni! - az attacment opcionális - A levelek kikuldese utan a fajl at lesz nevezve, level.datum.ido-re! Arra figyelni kell, hogy a TLMSG programnak legyen joga átnevezni a fájlokat! Különben nem is küld!

A testreszabási lehetőség annyi, hogy a kvthir_subject-ben és a txt/html fájlokban is használhatók ezek a makrók: ${textlib-user-name} - olvasó neve ${textlib-user-email} - olvasó email címe ${textlib-user-dref} - olvasó rekord azonosítója ${textlib-user-vkod} - olvasó vonalkódja ${textlib-user-stat-url}- olvasoi állapot URL ${textlib-current-date} - aktuális dátum ${textlib-lemond-url} - hírlevélnél a lemondó URL Pl: kvthir_subject=Zebegényi hírlevél - ${textlib-current-date}

Angol nyelvű levelek - mindegyik levéltipus: Ha az olvasóban be van állítva, hogy angol nyelvű leveleket szeretne (USER_NYELV mező, pl. Regisztrációnál, vagy web-es felületen állítható) A tlmsg.cfg-ben megadható mindenek az angol verzója, pl.: efelsz_subject_eng=Notification about books ready for pick-up Ugyanigy minden *_subject, *_vege, *_text, *_html esetén a _eng végződés adja meg az angol nyelvűt ujdok_ fájlokban (txt, html): ${textlib-gyarapodas-text-eng} - 11 honap / 11 month(s)

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 :-)

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.

Logfájl: kvthir.log

Kezdeti beállítások ~~~~~~~~~~~~~~~~~~~~~~~

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

- Rendszer/kvt.adatai menüpont: --- Használatba vett alrendszerek -- részben [Email] és/vagy [SMS küldés] beállítása

- Rendszer/kvt.adatai menüpont, [Paraméterek] ablakban: -- Email/SMS küldés -- részben a [Türelmi idő] és [Előre figyelmeztet] mezők, -- Költségek -- részben az [SMS díj] és a [EMAIL díj] mezők

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éltipushoz más-más fájlt tartozhat. Pl:

vfelsz_vege=/usr/share/tlmsg/felszolitas_visszahozatalra_vege.txt ffelsz_vege=/usr/share/tlmsg/fizetesi_felszolitas_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

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: ujdok.txt.pld (megnézhető itt: www.textlib.hu/txt/ujdok.txt.txt) ujdok.htm.pld (megnézhető itt: www.textlib.hu/txt/ujdok.htm.txt) azokat megnézve világos lesz a használat.

Használat élesben ~~~~~~~~~~~~~~~~~~~~~

tlmsg.cfg-ben: - email_sendto= törlendő. Akkor az olvasó valódi címére mennek email-ek. - sms_sendto= szintén. 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.

Statisztika ~~~~~~~~~~~~~~~

Újabb tlmsg verzióban már 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.

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: 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.

Beállítás - régi módszer, de még működik: Linux tlmsg.cfg-ben: sms_prog=/usr/share/tlmsg/tlsms.php sms_gateway=seeme seeme_user=xxx seeme_password=xxx # 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: A megfelelő menüpont kiválasztásával :-)

Beállítás - új módszer. SeeMe honlapon API KULCSot kell létrehozni. 1628 Linux tlmsg.cfg-ben: sms_prog=/usr/share/tlmsg/tlsms.php sms_gateway=seeme-key seeme_key=xxx

Érdemes elolvasni még: http://www.seeme.hu/eset_olcso_tomeges_sms.html

Meg kell adni egy ún. callback URL-t a seeme-nek. SMS kuldes eseten ezt hivja meg a kuldes adataival (pl. SMS kozpont fogadta az sms-t, sikeres a kikuldes, stb). Erre a celra keszitettunk egy seeme-callback.php scriptet. Ez at kell masolni pl. a /var/www/seeme/ konyvtarba. Ide 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 pedig a seeme-callback.php URL-jet kell megadni. Amivel kinti geprol elerheto. pl: http://konyvtarunkneve.hu/seeme/seeme-callback.php

Ilyen levelek várhatók:

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: - acNNNN - a dolgozó rekord dref-je TextLibben - 36205xxxxxx - a telefonszám - 16.00 Ft - az SMS ára

--- 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-ben például a vmmk esetében: 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 :-)

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

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

---------------------------- 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: - A KOV_EWARN mezőben a mai napot vagy annál régebbi dátumot tartalmazó kölcsönzéseket keresi le, és küld róluk figyelmeztetést. Kihagyja a feldolgozásból azokat a kölcsönzéseket, amelyekben: - már a határidő is lejárt - nem lenne 'előzetes' a figyelmeztetés - a kölcsönző olvasó nem kért emailt, vagy nincs neki email címe - A végén a feldolgozott kölcsönzésekből a KOV_EWARN mezőt törli, mert csak egyszer szólunk előre.

Előzetes figyelmeztetés működése - sms: - Mint az email, csak KOV_SWAN mezőt használva

Felszólítás visszahozatalra: - mai napi, vagy régebbi KOV_EFELSZ dátumú kölcsönzéseket keresi le -

Windows SMTP szerver beállítás ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- Ha a szerver hitelesítést igényel, akkor a hitelesítő adatokat is meg kell adni. - Lehet már SSL-el is küldeni levelet. - Ha nem sikerül a küldés, akkor az smtplog=1 beállítással lehet megnézni, milyen üzenetek mentek az SMTP szervere, és milyen válaszok jöttek onnan.

Példa 1 - nincs ssl, azonosítás szükséges

[smtp] server = smtp.szolgaltato.hu port = 25 ssl = 0 ; default smtplog = 0 ; default user = xxx password = yyy

Példa 2. - ssl kell, azonosítás is

[smtp] server = smtp.gmail.com port = 465 ssl = 1 user = gmailazonositom password = jelszavam ; smtplog = 0 ; default

---------------------------- innen már nem fontos --------------------

Kipróbálás ~~~~~~~~~~~~~~

Egy TESZT adatbázison ki lehet próbálni még a következőket is:

1. Kell egy ismeros olvaso, akinek van kolcsonzese. Ennek az olvasonak TLWWW olvasói állapotban beállítani, hogy kér email+sms-t, és előzetes figyelmeztetést is. Az olvasonak legyen email cime es mobilszama is beallitva.

2. Az olvasó egyik kölcsönzés rekordjában be kell allitani a KOV_EFELSZ mezot pl. a mai napra. Az mondja meg, mikor kell az email/sms felszolitas a kolcsonzes miatt. Ha a kölcsönzés rekord az xNNN, akkor: g-dbrun.exe /S86:xNNN=20100921

3. Ezek utan a tl_msg_vfelsz futtatasa mar kell kuldjon egy emailt es/vagy egy sms-t.

4. 'g-xvfelsz.exe /filluser' futtatasa. A filluser paramétert éles adatbázison NEEE!! Az olvasókba beállit fix (nem létező) email cimet, fix (formailag helyes, de nem létező) mobilszámot, es azt, hogy szinte mindannyian (90%-uk) kérnek emailt es sms-t is.

Van nehany kivetel. Ha az olvaso dref-nek utolso szamjegye (pl. ac3546.3-nal a 6-os :-): - 1 - nem lesz email cime az olvasonak - 2 - nem lesz mobilszama az olvasonak - 3 - nem ker email-t - 4 - nem ker sms-t Ezeknek email vagy sms nem fog menni kuldeskor.

Ha van atiranyitas, azaz sms_sendto ill. email_sendto is meg van adva tlmsg.cfg-ben, akkor az uzenetek oda mennek. Ilyenkor a program NEM konyveli el, hogy kimentek a levelek, mert hisz nem mentek ki...

Ha nincs atiranyitva, akkor kimennek a levelek, de visszajonnek, hogy rossz cimzett. Kiveve azokat az olvasokat, akiknek volt beallitva email cimuk. Azok megkapjak!!! SMS-eknel ez esetleg penzbe is kerul, ha az sms szolgalato a sikertelen SMS kuldesekert is szamlaz.

- /usr/share/tlmsg/tl_msg_vfelsz futtatas ezek utan eleg sok levelet kell eredmenyezzen.

Vissza: Kiegészitő programok TextLib honlap