|
 |
RAF i RAF Recenzje
|  | | |
Moduły wirtualne - RAF Formularze i RAF Recenzje służą do tworzenia modułów, które "fizycznie" nie istnieją - nie ma ich w postaci odpowiedniego kodu PHP jak w przypadku innych modułów. Jest to niemała zaleta - szybko i w prosty sposób bez edycji kodu PHP możemy mieć prawie dowolny moduł. Oba moduły umożliwiają generowanie modułów opierających się na określonym formularzu - podajemy kod formularza (pola, wartości itd.) i mamy moduł, który te dane wyświetla, powiedzmy chcemy zrobić moduł do indeksowania książek. Chcemy mieć pola:
- tytuł książki
- autor
- wydawnictwo
- recenzja
Tworzymy więc kod formularza w stylu:
W konfiguracji dla danego RAFu podajemy taki formularz i mamy moduł który będzie oczekiwał danych w takich polach oraz będzie je wyświetlał zgodnie z polami formularza:
Tytuł: Kamasutra
Autor: Zbylut z Wąchocka
Recenzja: bla bla bla bla
Tyle jeżeli chodzi o wprowadzenie do idei modułów... teraz konkrety.
RAF Formularze
- By stworzyć nowy moduł RAF Wirtualne Formularze wchodzimy do zakładki "Stwórz Tabelę RAF" w jego menu admina i wpisujemy liczbę porządkową dla tego modułu. Zalecem zaczynać od 1. Po wysłaniu formularza tabela zostanie utworzona i przeniesieni będziemy do konfiguracji RAFu.
- W domyślnej instalce RkCMF istnieje przykładowa konfiguracja dla modułu o id 1:
array
(
'tables' => array(1 => $this->tables[prefix].'rk_cmf_raf1'),
'names' => array(1 => 'Mody Baldurs Gate I'),
'tb1' => array(
'form' => '..dużo literek i cyferek..',
'field_names' => array(
'lang' =>'Polski język',
'typ' => 'Typ instalacji',
'komp' => 'Kompatybilność i Stabilność',
'links' => 'Strona moda i Download',
'easy' => 'Poziom Trudności',
'install' => 'Warto instalować?',
'desc' => 'Opis i zasoby:'),
'field_to_link' => array('links')
)
);
Konfiguracja stała: tables - zbiór istniejących tabel RAFów gdzie kluczem jest numer ID a wartością nazwa tabeli ($this->tables[prefix].'rk_cmf_rafID'). names - nazwy dla modułu RAF o danym ID.
Konfiguracja poszczególnych modułów: W powyższym przykładzie mamy tablicę przypisaną do klucza tb1 - dla każdego RAFu tworzymy jego konfigurację, przypisaną do klucza tbID_MODUŁU (tb1, tb2 itd.).
form - kod HTML formularza zakodowany BASE64_ENCODE (patrz niżej)
field_names - nazwy pól formularza, kluczem jest nazwa pola formularza (parametr name) a wartością fraza jaka będzie użyta przy wyświetlaniu wpisu (np. "Autor książki" zamiast "autor"
field_to_link - wpis opcjonalny, wartości z pól o nazwach (parametr name) podanych w tej tablicy zostaną automatycznie zamienione na linki (< a href="WARTOŚĆ" target="_blank" >Link< /a >)
Kodowanie base64 - w panelu admina w menu dla RAF Wirtualnych Formularzy mamy zakładkę o takim tytule. Dzięki niej szybko zakodujemy kod HTML formularza do postaci łańcucha base64, który musimy wstawić do konfiguracji modułu (można też odkodować zakodowany już formularz). Jeżeli znasz kod RkCMF dość dobrze to możesz też skorzystać z zakładki "Form class do HTML" za pomocą której zamienisz kod formularza generowany przez klasę form.class.php na kod HTML Formularza.
Formularz: Formularz dla RAFu nie jest typowym formularzem:
- nie wstawiaj tagów FORM ani przycisków wysyłających
- pole tytułu jest wbudowane w moduł (zawsze musi być) i nie twórz takiego pola w formularzu
- wpisuj parametr value (title) value="$nazwa_pola" np. dla pola o nazwie "autor" wpiszemy value="$autor", dla textarea umieść $nazwa_pola między tagami.
- dla pól select pierwszą opcją powinno być: < option >$nazwa_pola< /option >
- powyższe $nazwa_pola są wymagane by podczas edytowania wpisu wcześniej wprowadzone dane były wyświetlone
Po wprowadzeniu konfiguracji możemy dodawać wpisy. Po kliknięciu na "Dodaj wpis" najpierw zobaczymy listę dostępnych RAFów a dopiero po wybraniu jednego z nich - będziemy mogli dodać do niego wpis. Tak samo gdy na stronie chcemy przeglądać wpisy: index.php?mod=raf&act=show (pamiętaj o możliwości listowania poprzez ContentBBcode)
RAF Recenzje
Moduł bardzo podobny do RAF Wirtualnych Formularzy. Różni się jednak paroma opcjami - jak sama nazwa wskazuje wpisy mogą być recenzowane (dodawanie recenzji) oraz można dodawać grafiki (jeżeli włączymy tą opcję). Dodatkowo listę wpisów można wyświetlać sortując wg. wartości jakiegoś pola - np. pola z oceną. Konfiguracja podobna:
array
(
'tables' => array(1),
'names' => array(1 => 'Mody Baldurs Gate I'),
'tb1' => array(
'form' => '...dużo literek i cyferek...',
'field_names' => array(
'lang' =>'Polski język',
'typ' => 'Typ instalacji',
'komp' => 'Kompatybilność i Stabilność',
'links' => 'Strona moda i Download',
'easy' => 'Poziom Trudności',
'install' => 'Warto instalować?',
'desc' => 'Opis i zasoby:'),
'field_to_link' => array('links'),
'allow_gallery' => true,
'gallery_link' => '[TITLE]',
'stat_fields' => array('komp' => array('słaba', 'wysoka', 'no comment'))
)
);
tables - to samo (tyle że nie podajemy nazwy tablicy, po prostu same ID, np: 1,2,3), names - to samo, tak samo tworzy się konfiguracje poszczególnych RAFów - tbID. Nowe opcje to:
allow_gallery - true - pojawi się opcja dodania grafiki, false - nie
gallery_link - link pod "Zobacz galerie". Jeżeli wpiszemy tutaj jakiś to będzie taki sam dla wszystkich wpisów z tego RAFu lecz jeżeli chcemy mieć dla każdego oddzielną galerię to wpisujemy [TITLE] - co zostanie zamienione na link do artykułu o takim samym tytule jak tytuł wpisu.
stat_fields - zawiera tablicę asocjacyjną, klucze to nazwy pól a wartości to zwykłe tablice zawierające możliwe wartości - dodanie pełnego wpisu dla danego pola oraz wprowadzenie jako treści frazy [STAT] (przy dodawaniu wpisu) spowoduje że będzie on polem wyboru (ankietą). Dodatkowo jeżeli możliwe do wyboru będą wartości liczbowe to wartość średnia oddanych "głosów" będzie używana przez RAFSTAT.
Dodawanie grafik nie dodaje ich lecz wysyła na email admina (konfiguracja strony - admin_mail). Jeżeli uznamy że warto dodać grafikę do dodajemy/edytujemy odpowiedni artykuł i ładujemy grafikę np. poprzez [ADD=ścieżka]. Po dodaniu konfiguracji można dodawać wpisy. Jeżeli użytkownik doda recenzję - odpowiedni wpis pojawi się w logach admina. Jeżeli osoba (np. admina, redaktor) ma prawa "raf, edit" będzie mogła edytować/kasować recenzje.
Moduł RAF Wirtualne Formularze określany jest czasami jako po prostu "RAF". Moduł RAF Recenzje zawsze opisywany jest pełną nazwą.
|
| |  | |  |
|