Topikok

Rewired 2.0 - RWThumbs

Funkcioja lokalisan tarolt JPG belyegkepet kesziteni, vagy torolni, illetve azok szamat merni es limitalni. Legtobb ismert formatumu kepet tudja kezelni, mint bevitel. A mukodesi elve hogy megadunk neki egy kulso webcimet amelyen talalhato az adott megcelzott kep, megadunk neki tovabbi adatokat es a vegen bemasolja a megfelelo helyre a lokalis szerverunkre az igy elkeszitett belyegkepet.

Letoltes:
https://www.rewired.hu/sites/default/files/development/rwthumbs.zip

Telepiteshez lepesek:
1) Valamilyen PHP kodot es MySQL-t mukodteto rendszer, pl en XAMPP-ot hasznalok.

2) Sima Drupal 7.x telepites

3) Be kell masolni a kicsomagolt “rwthumbs” direktorium tartalmat a “{DrupalTelepites}/sites/all/modules” direktorium ala.

4) Drupalban bekapcsolni a “RwThumbs“ modult. (menusor: modules->rwthumbs bekapcs)

5) Drupalban resetalni a cache-t, hogy aktivizalja magat a friss kod (menusor: configuration->performance->clear all cache gomb)

6) Keszen vagy.

Hasznalatahoz az \RWThumbs::create() funkcio-ba csak array-kent adagolni kell a tetszoleges parancsokat es azok opciojat:

'fullPath' => '{tetszolegesUtvonal}'
- lokalis szerverunkon pontosan hova generalja a belyegkepet (egeszen a fajlnevet is beleertve)

'imageUrl' => '{tetszolegesUrlCim}'
- Hol talalhato a megcelzott kep?

'exifNumber' => '{exifSzam}' vagy ignoraljuk az opcionalis parancsot
- Ha van, itt adhatjuk meg a kep EXIF szamat. Ha elozoleg nem olvastuk ezt sehol le, a progi megnezi nekunk a kulso linken keresztul, de lekereseket es felesleges szerver-szerver kommunikaciokat sporolhatunk meg ha mar elozoleg valahol kinyertuk es itt csak megadjuk.

'quality' => 0 tol 100-ig INT (default 75)
- A generalt belyegkep JPG minoseget hatarozza meg.

'overwrite' => TRUE (default) vagy FALSE
- Ha azt akarjuk hogy ne irja ujra az adott kepet a funcio lehivasaval, ha elozoleg ugy detektalta hogy mar megvan, akkor tegyuk FALSE-ra. Eroforrasokat sporol meg ebben az esetben.

Az \RWThumbs::delete() funkcio-ba array-kent adagolhato parancsok:

'fullPath' => '{tetszolegesUtvonal}'
- Lokalis szerverunkon pontosan melyik belyegkepet torolje. Hasznalhato wild-card is az utvonalban, pl: c:\drupalprogi\kepnevkezdet*.*

Rewired 2.0 – RwHttp

Funkcioja hogy affele szerver-oldali, konnyen kezelheto bongeszo legyen. Azaz kulonbozo modon lekerhessen adatokat kulso weboldalokrol, majd azokat tetszolegesen analizalni tudjuk es attol fuggoen utasitasokat vegrehajtani. Regex utasitasokat is megadhatunk (reszletekrol majd leljebb), es azoknak fejeben ha megtalalta azokat, nem tolti tovabb a potencialis nagy fajlokat, csak a kello anyagot tolti le. Aszinkron (non blocking) modban is tud kuldeni adatokat; connection timeout-ot es csomo egyeb hibat is kezel, jelent, mintsem hogy betorne a progi ha ezek fellepnek. Azonfelul tovabbi kisebb HTTP ugyekkel kapcsolatos segedfunkciokat is tartalmaz.

Eredetileg az RWMedia backend resze volt, de innentol kezdve kulon modulkent tartom fenn, mivel onmagaban is egy bazi hasznos szerszam minden egyeb fejlesztes/teszteles szempontjabol. Drupalon kivuli szitukban is, ugy altalanosan a PHP-ben.

Letoltes:
https://www.rewired.hu/sites/default/files/development/rwhttp.zip

Telepiteshez lepesek:
1) Valamilyen PHP kodot es MySQL-t mukodteto rendszer, pl en XAMPP-ot hasznalok.

2) Sima Drupal 7.x telepites

3) Be kell masolni a kicsomagolt “rwhttp” direktorium tartalmat a “{DrupalTelepites}/sites/all/modules” direktorium ala.

4) Drupalban bekapcsolni a “RwHttp“ modult. (menusor: modules->rwhttp bekapcs)

5) Drupalban resetalni a cache-t, hogy aktivizalja magat a friss kod (menusor: configuration->performance->clear all cache gomb)

6) Keszen vagy.

Telepiteshez lepesek, ha nem akarod Drupallal hasznalni, csak sima PHP projektekben:

1) A 'http.inc' fajlt nevezd at 'http.php' fajlra, es masold be a projektedbe majd hivd ahol akarod a kodban. A tobbi fajlt ignoralhatod mert azok csak a Drupalnak kellenek.

2) Keszen vagy.

Hasznalati elve:

Egyszeruen csak hivni kell a Class-t es a request funkcionak array-ben adagolni a parancsokat, pl:

$valasz = \RwHttp::request([
'parancs' => 'parancsOpcio',
'parancs2' => 'parancsOpcio2',
...
]);

vagy ha aszinkronba akarunk csak kuldeni, es nem erdekel a visszajelzett valasz (ami utobbi potencialisan egy lassu, vagy nem jelzo szerverrol 1-2 percre is felfoghatja a futo kodot) :

$valasz = \RwHttp::requestAsync([
'parancs' => 'parancsOpcio',
...
]);

A request() funkcioban visszakuldott valtozoban array-ben megkapjuk:
- a 'headers'-eket, amelyek szinten array-ben vannak rendezve. Igy pl barmilyen kod lefuttatas elott tesztelhetjuk hogy okes e a valasz, pl:
if ($valasz['headers']['status-code'] === '200') {...}

- az altalunk kuldott HTTP 'request'-et, amivel igy lathatjuk pontosan hogy mit is latott rolunk a megcelzott szerver, igy ha valami nem koserul ment el, itt csekkelhetjuk:
$valasz['request']

- es termeszetesen a megcelzott szerver altal visszavalaszolt adatokat, legyen az textualis szoveg, vagy barmifele mas binaris adat:
$valasz['data']

A 'request()' funkcioban megadhato parancsok, es parancs-opciok:
'url' => '{vamilyenSzoveg}'
- A megcelzott weboldal.

'referer' => '{vamilyenSzoveg}'
- Ezzel szimulalhato hogy a keres melyik tetszoleges weboldalrol jott.

'requestType' => 'GET' (default) vagy 'POST' vagy 'HEAD'
- HTTP request tipus.

'data' => '{valamilyenAdat'}
- ha POST request-et kuldunk, itt adhato meg a kuldott adat.

'followLocation' => 'TRUE' (default) vagy 'FALSE'
- ha tobb relocation van mielott elernenk a vegso szervert es nem szeretnenk hogy azokon vegigmenjen az RWHTTP hanem visszajelezzen az elsonel, akkor ezt ki kell kapcsolni.

'escape' => 'TRUE' vagy 'FALSE' (default)
- ha kepernyore akarjuk kiiratni a visszakapott 'data' uzenetet, akkor potencialisan nem szeretnenk hogy leffussanak a kapott HTTP tagok hanem azt ha forras formaban maradnak. Ezt bekapcsolva nem futnak le.

'charLimit' => 0 (default) vagy tetszoleges INT szam. 0=nincs limit.
- Limitalja a letoltott adatok mennyiseget byte-ban. Azaz pl ha potencialisan nagy fajlt celzunk meg, de csak az adat elso reszeit szeretnenk analizalni, akkor ezzel elerhetjuk konnyen hogy ne toltse le a tobbit, csak a szigoruan megengedett mennyiseget.

'pattern' => '{tetszolegesRegex'}
- Tetszoleges regex, amit keresni fog a RWHttp a lekert webcimrol visszajelzett adatban.
Ha ezt hasznaljuk, akkor a RWHttp visszajelzes array kibovul tovabbi ket valtozoval:
'patternMatchCount' es 'patternMatchArr'
Az elso jelzi hogy hanyszor talalta meg az altalunk megadott regex parancsot, a masodik meg gyujti egy array-ben sorra azokat, a szamukra tetszolegesen felhasznalni a kesobbiekben.

'patternMatchCountLimit' => 0 (default) vagy tetszoleges INT szam. 0=nincs limit.
- Meghatarozott max talalat limit. Ha ezt megadjuk, akkor a limit elerese utan nem tolti tovabb az adatokat a szerverrol, hanem visszajelez. Celszeru akkor hasznalni, ha tudjuk pontosan mennyit keresunk az adott regex-bol, igy ha megtalaltuk amit kerestunk, nem kell tovabb toltelunk egy potencialisan joval nagyobb fajlt.

'customHeaders' => '[
'customHeader1', 'customHeader2', ...
];
- array-ben, vesszovel elvalasztva egymastol meg tudunk adni barmifele custom HTTP header adatot is, ha epp kellene a request-hez. Pl HTTP-ben elkuldott authentication certification vagy hasonlo szituknal siman jo ha konnyen hozza tudjuk csatolni a kello informaciokat. Vagy ha custom sutiket, vagy ilyesmiket akarunk csatolni.

Rewired 2.0 – RwMedia Integration.

A feladata:
- a Drupal-t felkesziteni a Rewired kornyezetben megszokott beagyazas folyamataira. Minden szukseges dependency modult automatikusan kervenyez es bekapcsol (elotte le kell viszont tolteni es bemasolni oket, ha nincsenek a gepen). Gyakorlatilag egy friss Drupal telepites utan beallit nekunk mindent es oszekoti az RWMedia frontendet a backenddel, majd mukodove teszi a beagyazast ha pl forumkomment kuldesnel Media tagok koze pakkolunk tetszoleges URL anyagokat.

- Automatizalni a munkalatokat a hatterben, amikor pl elkuldunk illetve frissitunk egy topikot vagy kommentet. Aszinkron modban effektiven kezeli ezeket munkalatokat, azaz azonnal visszadja a felhasznalonak az eroforrasokat, amint kiadtuk a parancsot.

- Kinyerni az Open Graph hatterkepet es rovid leirast (facebook es hasonlo sharing-hez a preferalt informaciok) a beagyazott tartalmak es irott szoveg analizalasabol. Ha nincs mukodokepes hatterkep vagy irott szoveg, hasznalja az alapertelmezettet.

Igy kell egy friss Drupal telepitesen hogy kinezzen, ha minden okesan funkcional:
rwurl=https://imgur.com/WmVpWRo

Dependency lista:
- Drupal core: Forum
- Drupal core: Poll
- Drupal core: Php
- Xbbcode (Extendable BBCode)
- Rewired: RW Media backend
- Rewired: RW Media frontend

Letoltes:
https://www.rewired.hu/sites/default/files/development/rwmedia_integrati...

Telepiteshez lepesek:
1) Valamilyen PHP kodot es MySQL-t mukodteto rendszer, pl en XAMPP-ot hasznalok.

2) Sima Drupal 7.x telepites

3) Be kell masolni a kicsomagolt “rwmedia_integration” direktorium tartalmat a “{DrupalTelepites}/sites/all/modules” direktorium ala.

4) Drupalban bekapcsolni a “RwMedia Integration“ modult. (menusor: modules->rwmedia_integration bekapcs)

5) Legtobb dolog beallitasat es letrehozasat automatizaltam a telepitesnel, de a xbbcode-nak az API-ja tul komplikalt kezelesu atneznem es kiismernem, viszont kezzel letrehozni ami kell az RWnek meg pofonegyszeru. Igy jarunk el utobbi modszerrel akkor:

5a) Nyisd meg a BBCode konfiguracios lapjat (menusor: configuration->BBCode)

5b) kattints a Create New Tag-ra

5c) beallitasok itt:
name of this tag: media
description: media
sample tag: media
csekkeld be: Ignore further BBCode inside this tag.
csekkeld be: Escape all HTML inside this tag.
csekkeld be: Evaluate as PHP code.
Rendering code:

if (module_exists('rwmedia_backend')) {
echo \RWMedia\Crypto::generateRwid($tag->content);
}

5d) save a beallitasokat itt

6) Drupalban resetalni a cache-t, hogy aktivizalja magat a friss kod (menusor: configuration->performance->clear all cache gomb)

7) Keszen vagy.

RwMedia API eleres webpontok:

NODE_UPDATE
- Funkcioja hogy topik/comment frissitesnel vagy eredeti kuldesnel elinditsa a beagyazast analizalo es hasonlo hattermunalakatokat. Kinyerje es hozzacsatolja az Open Graph adatokat a socialis halozatoknal valo megosztasokhoz.

- webcim: “{DrupalWeboldal}/rwmedia/node_update”

- hozzaferes ehhez az API ponthoz csak bejelentkezett adminisztratoroknak, es a rendszernek (appId-n keresztul) van. Design szerint csak a rendszer hivhatja, ha fejleszteni szeretnenk akkor csekk a kapcsolatos funkciokat a kodban, hogy milyen POST adatokat kovetelnek (az administrator bejelentkezesen kivul).

RwMedia integration fajlok funkcioja, nagyvonalakban?

Rwmedia_integration.info
Itt tarolja a dependency informaciokat. Plusz tovabbi sima informaciok a Drupal-nak az adott modulrol.

rwmedia_integration.module
Itt tarolodnak az ugynevezett “hook”-ok, azaz a funciok amelyek segitsegevel interaktalni tudunk a Drupal belso funkcionalitasokkal es moduljaival. Azaz pl itt hivja a rendszer a topik/comment insert es update pillanatoknal a tovabbi RwMedia funkciokat.

rwmedia_integration.install
Elkesziti az RWMedia altalt hasznalt mezoket a Drupal-ban, es ugyanugy torli is oket, ha uninstallaljuk a rwmedia_integration modult. Elkesziti a kello direktoriumokat es bemasolja a kello fajlokat is.

database.inc
Adatbazissal valo interakciokat tartjuk itt. Peldaul itt irja a rendszer be az Open Graph anyagokat a megfelelo mezokbe, illetve itt nyeri ki az elkuldott szovegbol az Open Graph rovid-leirast.

node.inc
Itt tarolunk minden tovabbi program logikat, ami a node_update API hivas utan lejatszodik a rendszerben.

Rewired 2.0 – RwMedia Frontend.

Ez az RwMedia beagyazas Frontent-je. Nagyreszt VUEjs alapu (es kis reszben jQuery, az ajax resze pl).

rwurl=https://imgur.com/vs8LQyI

A mukodesi elve (nem tul reszletesen belefolyva) ket fo lepesbol all:
1) Beinjektalja magat egy (elozoleg a programozo altal) tetszolegesen kivalasztott DOM elem-re es megnezi hogy van e legalabb 1 “rwid={id}” bejegyzes valahol benne. Ha van, akkor aktivizalja a frontend magat. Ha nincs, inaktiv marad. Az {id} formatum a backend altal generalt 44karakteres base64 ID, ami egy adott beagyazott tartalmat reprezentalja. De ez az ID lokalisan is szimulalhato, kezzel barmi beirhato a tesztben.
2) A masodik lepes hogy egyezteti ezeket a kiragadt ID-ket a lokalis kis adatbazisaban (entryObjects), es ha egyezik valamelyikkel, akkor elkezdi kirajzolni azokat az elemeket a rendeltetesuk szerint. Azaz ha youtube videorol van szo akkor kirajzolja az indito play gombot es a statikus hatterkepet, ha sima keprol van szo akkor meg az HTML IMG tagokat a forras URL kore, stb stb.

Ez az adatbazis a reaktiv resze a programnak, barmi valtozik bennuk vagy friss adat kerul oda, azzal automatikusan frissul es atrendezodik a kapcsolatos webelemek kirajzolasa is.

Egyik hasznos funkcioja, hogy a beagyazott elemek dimenziojat elore kimutatja es elfoglalja maganak, fuggetlenul hogy azok beolvasodtak vagy sem. Pl ez kepes beszurasoknal hatalmas elony, mivel a egyszeru HTML-el kepeknel ahogy olvasodnak be ugy nyomjak szet maguk korul az elemeket, igy allandoan idegesitoen elmozdul az olvasott anyag. Viszont az RwMedia beagyazasnal stabilan mindig ott marad a scroll ahova eredetileg is tettuk es szerettunk volna szoveget olvasgatni.

Letoltes:
https://www.rewired.hu/sites/default/files/development/rwmedia_frontend.zip

Telepiteshez lepesek, "ha Drupal nelkul csak kulon akarod tesztelni/fejleszteni" verzio:
1) A legfontosabb hogy szerverrol kell hogy fusson, mivel a legtobb modern bongeszo stresszel ha egy javascript file tovabbi lokalis fajlokhoz akar hozzaferni, mint kepek es hasonloak. En XAMPP-ot hasznalok, de barmi megteszi vegulis mivel a szerverrol futason kivul semi mas nem kell neki.
2) Be kell masolni a kicsomagolt “rwmedia_frontend” direktorium tartalmat egy tetszoleges helyre a lokalis szerveren.
3) Keszen vagy.

Teszt:
Bongeszoben elinditod a local_test.html fajlt (lokalis szerveredrol valahonnan). Peldaul: “localhost/rwmedia_frontend/test/local_test.html”

Telepiteshez lepesek, "ha Drupallal es az RW2.0 tobbi moduljaval integralni akarod" verzio:
1) Valamilyen PHP kodot es MySQL-t mukodteto rendszer, pl en XAMPP-ot hasznalok.

2) Sima Drupal 7.x telepites

3) Be kell masolni a kicsomagolt “rwmedia_frontend” direktorium tartalmat a “{DrupalTelepites}/sites/all/modules” direktorium ala.

4) Drupalban bekapcsolni a “RwMedia Frontend“ modult. (menusor: modules->rwmedia_frontend bekapcs)

5) Drupalban resetalni a cache-t, hogy aktivizalja magat a friss kod (menusor: configuration->performance->clear all cache gomb)

6) Keszen vagy.

RwMedia frontend fajlok funkcioja, nagyvonalakban?

Local_test.html
Ezt inditsd el ha lokalisan adagolt informaciokkal szeredned tesztelni az rwMedia frontendet. Azaz peldaul ha rwMedia backend (es pl Drupal telepites, es mindenfele PHP) nelkul akarod szimulalni az adatokat tetszolegesen, es tesztelni hogyan viselkedik kulonbozo esetekben a frontend.

Local_test.js
Itt a testInputHTML valtozo tartalma pl egy comment vagy topik tartalmat szimulalja. Atirhatod ahogy akarod, a lenyege hogy legyen benne legalabb 1 “rwid={id}” bejegyzes, hogy beaktivizalja magat a frontent motor. Ha nincs egy rwid={id} bejegyzes, akkor ugyan elindul a test, de nem aktivizalja magat az rwmedia frontend, mert nincs munkaja. Pelda az rwid bejegyzesre:
rwid=Xso58Z06OcWbcVzcLv6@Txkci5L4sTeQhdqKmTfPwmk-

Itt a masik valtozo a testEntryObjects. Ez szimualja a tesztben az rwmedia_backend adatbazisbol kinyert tartalmak adott helyzetet, a bejegyzesek reprezentaciojarol es aspektusairol, ID-re lebontottan kulon kulon. Ezek az EntryObjects-ek a reaktiv resze a programnak, barmi valtozik bennuk vagy friss adat kerul oda, azzal frissul a webelemek kirajzolasa is.

Mivel szimulalt informaciok ezek, nyugodtan lehet vadulni valotlan adatokkal es tesztelgetni kulonbozo helyzetekben a kulonbozo ertekeket.

Online_test.html (ertelemszeruen kapcsolatos az online_test.js ugye)
Ezt inditsd el ha pl rwMedia backend-el egyutt akarod tesztelni a frontendet. Elotte meg kell mutatnod neki hol keresse a backendet. Hogy ezt megtedd, menj az “rwmedia_frontend” konyvtaron belul a “/js/rwmedia_settings.js” fajlba es add meg a backend elerhetesi utvonalat.

Amugy az online es local test-nek majdhogy nem teljesen megegyezik a mukodesi elvuk, a kulonbseg hogy az online_test ajax-on keresztul csekkeli a backendet a folyamatban levo feltoltesek vagy munkaknal, es frissiti a kimutatasra szant reaktiv adatbazist.

Test.css
Csak a szimulalt weblap kirajzolast segito par css informacio.

Rwmedia_frontend.info
Alap informaciok a modulrol a Drupal szamara. Plusz itt rendeli hozza a Drupal-hoz a kapcsolatos CSS es JS fajlokat.

Rwmedia_frontend.module
Mivel egyelore az elore elkeszitett lapokat kapunk a Drupaltol oldalnezegeteseknel, a RWMedia Frontend modul minden lapnyitasnal:
- atfesuli azok tartalmat
- majd kinyeri beloluk az adatbazisbol az osszegyujtott beagyazott objektumok tartalmat
- majd egy specialis javascript valtozoban (Drupal.settings.entryObjects) elerhetove teszi a frontend szamara azokat, mielott a lap megjelenne, hogy sikeresen felepithesse a kello kapcsolatos media web-elemeket

Javascript fajlok:

Rwmedia_drupal_init.js
Ezzel injektalja az RWMedia Frontend modult bele a Drupal a forumlapokra dolgozni, minden lapnyitasnal.

Rwmedia_module.js
Ez a frontend modul objektum, es a lelke az rwmedia frontendnek. Itt talalhatoak alaplogikai a programnak, es itt indithatoak el a kulonbozo funcioi.

Maga a modul ugy mukodik mint egy class. Vannak attributjai, azutan privat es publikus funcioi is. Automatikusan legeneralja a mukodeshez szukseges attributomok alaperteket, viszont tetszolegesen meg is adhatjuk kulsoleg oket neki az initalizalo hivasnal, akkor viszont azokat fogja hasznalni. Pl:

let rwmm = RWMediaModule({
appElementName: '#page',
retryTtl: 0,
});

Ha initalizalas utan inditani akarjuk, akkor hivhatjuk a process() funciot es megadhatjuk benne az atnezendo HTML reszleget, es az elozoleg kinyert (vagy kezileg szimulalt) EntryObjects adatbazist:

rwmm.process(testInputHTML, testEntryObjects);

Ezutan a modul elkezd dolgozni es elkezdi hasznalni a “components” direktoriumba levo komponens elemeket, hogy megszerkessze az adott bejegyzeseket.

c_rwmedia.js
Alap rwmedia komponens. Ez kirajzolja a Status uzenetet, es az URL-t, majd iranyitana rajzolni a tobbi alkomponenst, ha kell.

A Status szovegre kattanva atiranyit minket egy uj tab-ra, es beolvassa nekunk az adott bejegyzesre a backend altal legeneralt adatokat. Kenyelmes szerszam arra hogy pl egyeztessuk a backend altal mutatott, es frontend altal latott adatokat.

c_rwmedia_image.js
Sima kep-beagyazasokat rajzol ki.

c_rwmedia_image_animated
Tipikusan a GIF cuccokat segiti kirajzolni

c_rwmedia_stream.js
Barmilyen IFRAME alapu es streameheto beagyazas kimutatasat segiti. Pl mint souncloud vagy youtube.

c_rwmedia_video.js
Direkt-linkes videok beagyazasanak kimutatasat segiti.