Ndertim I Moduleve shtese ne PikaCMS – Manual per zhvilluesin ! - Artikuj

Ndertim I Moduleve shtese ne PikaCMS – Manual per zhvilluesin !

Tashme PikaCMS gjendet ne versionin e 2-te dhe besoj qe eshte momenti te publikoj nje miniguide te vogel per zhvilluesit.
Ne kete manual do te ndertojme nje modul te thjeshte I cili do te mundesoje shfaqjen e disa linqeve ne nje bllok anesor te titulluar partnere. Mora kete shembull pasi nuk egziston ende nje modul I tille per PikaCMS, keshtu do ta zhvillojme se bashku.

Fillimisht duhet te arsyetojme cfare duhet te shfaqet ne kete bllok dhe si mund te strukturojme tabelen tone mysql.
Per te vendosur nje link, duhet te vendosim nje emertim per linkun dhe adresen url ku do te dergohet vizitori qe klikon. Keshtu fare thjeshte mund te krijojme tabelen tone mysql me keto detaje. Tabelen do ta quajme partnere dhe do te permbaje 3 kolona: nr, emertimi, url :

Kodi:

CREATE TABLE `partnere` (

`nr` INT NULL AUTO_INCREMENT ,
`emertimi` VARCHAR( 254 ) NOT NULL ,
`url` VARCHAR( 254 ) NOT NULL ,
PRIMARY KEY ( `nr` )

) ENGINE = MYISAM ;

Tabelen mund ta krijojme duke perdorur opsionin SQL Query nga paneli I administrimit, nga phpMyAdmin ose nga nje shell direkt ne serverin mysql. Vendosni menyren qe ju pelqen me shume.
Pasi kemi krijuar kete tabele do te na duhet te krijojme modulin administrativ.
Krijoni nje folder ose kartele ne direktorine mods ne panelin e administrimit te emertuar partnere. (kujdes: specifikoj qe germat kane rendesi. Lowercase ose Uppercase duhet te mbani mend si e beni emertimin e karteles)
Brenda saj kopjoni te gjithe dokumentat qe gjenden ne folderin modul_shembull.
Gjenden disa dokumenta si adm,shto,fshi,fshi2, leje dhe mod.
Hapni me editorin tuaj te preferuar dokumentin adm.php. Ndryshoni stringen XXX me emrin e modulit qe ne rastin tone eshte partnere. Ndryshoni gjithashtu termat e ndryshem te cilet pershkruajne veprimet e ndryshme si Administrim I modulit shembull ose Emertimi I modulit shembull etj ne termat e duhur per modulin perkates.

Tani hapni dokumentin main.php.

Modifikoni XXX me emrin e modulit, qe ne rastin tone eshte partnere.
Meqe shembulli qe po realizojme aktualisht eshte I thjeshte nuk do te shtojme kolona te tjera per shfaqje por vazhdojme me rregullimin e dokumentave te tjere.

Hapim dokumentin shto.php
Ndryshoni XXX ne emrin e modulit perkates, ne rastin tone partnere.
Ne shembullin qe gjendet ne faqen e shtimit, rezulton vetem nje kolone. Duhet te shtojme edhe nje inputbox tjeter e cila do te permbaje adresen url.
Shtoni ne formen e shtimit duke shtuar nje rresht ne tabelen aktuale :

Kodi:

Me pas modifikoni querien MySQL me shtimin e ri nga :

Kodi:

$insertSQL = sprintf("INSERT INTO $tabela (`emertimi`) VALUES (%s)",
GetSQLValueString($_POST['titull'], "text"));

Ne :

Kodi:

$insertSQL = sprintf("INSERT INTO $tabela (`emertimi`,`url`) VALUES (%s,%s)",
GetSQLValueString($_POST['titull'], "text"),
GetSQLValueString($_POST['url'], "text"));

Keshtu edhe forma e shtimit eshte gati.

Hapim dokumentin fshi.php
Ndryshoni XXX ne emrin e modulit perkates, partnere.

Hapim dokumentin fshi2.php
Ndryshoni XXX ne emrin e modulit perkates, partnere.

Hapim dokumentin mod.php
Shembulli, si ne dokumentin shto.php permban vetem nje hapsire modifikimi. Duhet te shtojme nje rresht tjeter e cila do te permbaje linkun url :

Kodi:

Tani duhet te modifikojme querien mysql nga :

Kodi:

$updateSQL = sprintf("UPDATE $tabela SET `emertimi`=%s WHERE `nr`=%s",
GetSQLValueString($_POST['titull'], "text"),
GetSQLValueString($_POST['nr'], "int"));

Ne :

Kodi:

$updateSQL = sprintf("UPDATE $tabela SET `emertimi`=%s, `url`=%s WHERE `nr`=%s",
GetSQLValueString($_POST['titull'], "text"),
GetSQLValueString($_POST['url'], "text"),
GetSQLValueString($_POST['nr'], "int"));

Ndryshoni XXX ne emrin e modulit, partnere.
Tashme te gjithe dokumentat administrative jane gati per pune. Shkojme ne panelin e administrimit dhe klikojme ne butonin Modulet.
Ne dritaren e moduleve klikojme ne linkun Shto Modul te instaluar me pare.
Vendosim emertimin e modulit tone : partnere dhe titullin Partnere.
Tani mjafton te shkojme ne listen e moduleve dhe te klikojme ne linkun partnere.
Mund te fillojme te shtojme linqet dhe partneret e faqes tone.

Shenim : Dua te kujtoj qe ky manual sherben me shume per fillestaret ne php/mysql pasi tregohen te gjitha hapat ne detaje. Nese keni njohuri te mira ne php/mysql mund te ndertoni module edhe me te komplikuara. Struktura eshte shume e thjeshte dhe shume e pershtatshme.

Pasi kemi perfunduar anen administrative te modulit tone do te na duhet te krijojme dhe bllokun anesor ne te cilin do te shfaqen keto linke.
Shkoni ne direktorine blloqe qe gjenden ne root e instalimit te pikacms. Krijoni nje document te ri te emertuar b_partnere.php dhe kopjoni ne te permbajtjen qe gjendet ne dokumentin b_shembull.php

Permbajtja e bllokut hidhet ne variablin e quajtur $permbatja. Ndertojme querine tone mysql per shfaqjen e linqeve :

Kodi:

<?php
//bllokim i hapjes direkte te faqeve url. Cdo faqe ne kete sistem duhet te kaloj ne indeksin kryesor.
//nese faqja hapet direkt, shfaqim dokumentin .php bllokim.php i cili eshte i personalizueshem.
defined('v') or die(include('bllokim.php'));
//fund
//azerojme vleren e $permbajtja nga vlerat e mundeshme te meparshme dhe i ngarkojme vlerat e reja !

$permbatja='';
$th_partnere=sprintf("select * from partnere");
$rez_partnere=mysql_query($th_partnere);
while ($r_partnere=mysql_fetch_assoc($rez_partnere)) {
$permbatja.="<a href=\"".$r_partnere['url']."\" target=\"_blank\">".$r_partnere['emertimi']."</a><br />";
}mysql_free_result($rez_partnere);
include ('templates/'.modeli.'/bllok.php');
?>

Ruani kete document dhe shkoni ne panelin e administrimit. Klikoni ne linkun Shto nje Bllok
Vendosni emertimin e Bllokut Partnere
Zgjidhni dokumentin b_partnere.php
Gjendjen Aktive
Pozicionin supozojme 2 dhe vendin majtas ose djathtas sipas deshires.
Do te shikoni qe keni nje bllok dinamik te cilin e administroni nga paneli I administrimit. Tashme mund te shtoni ose fshini linqe ose partnere sipas deshires.
Gjithesesi, nese do te keni problem ne ndertimin e ketij moduli ne pjesen shkarkime te faqes pikacms.com do te gjeni paketen e plote te perfunduar e cila u ndertua hap pas hapi duke u bazuar ne kete manual.

Perseris edhe nje here qe ky manual eshte shume I thjeshte. Bazohet ne ndertimin e nje moduli te thjeshte . Shpresoj qe gjithesei te keni krijuar nje ide me te qarte mbi zhvilliminn e moduleve ose sherbimeve shtese ne PikaCMS.

Bledar Leka
Janar, 2010.