FCKeditor bevezető

Több WYSIWYG szerkesztő létezik Drupalhoz, mi mégis legtöbbször az FCKeditort ajánljuk és telepítjük ügyfeleink számára. Alább olvasható egy rövid(?) bevezető, néhány műhelytitokkal.

Vastag betűvel az emlékeztetők, haladóknak ellenőrzőlista helyett.

Előfeltételek

Működő Drupal oldal (ennek beállításaival jelen írás nem foglalkozik). A megadott elérési utak Drupal 6 szerintiek, a funkcionalitásuk viszont megvan Drupal 5-ben is (többnyire ugyanazon elérési úton, de ezt jelen írás készítésekor nem próbáltuk végig).

Telepítés

1. Töltsük le a modult, csomagoljuk ki a sites/all/modules könyvtárba, így létrejön többek között egy sites/all/modules/fckeditor/README.txt fájl is. (Ez a fájl gyakorlatilag minden szükséges információt tartalmaz, ezért is készül ez a bevezető csak magyarul.)
2. Töltsük le magát az FCKeditort, csomagoljuk ki a sites/all/modules/fckeditor könyvtárba, így létrejön többek között egy sites/all/modules/fckeditor/fckeditor/fckconfig.js fájl is.
3. Az aláhúzásjellel kezdődő dolgok akár törölhetők is, Drupalban nincsen rájuk szükség.

Beállítás

1. Kapcsoljuk be a modult a http://example.com/?q=admin/build/modules címen.
2. Adjunk legalább egy csoportnak access fckeditor jogosultságot a http://example.com/?q=admin/user/permissions címen - enélkül nem tudjuk a modulnak megmondani, kik és hogyan használhatják, azaz hiába állítgatunk bármit, csak a hagyományos szerkesztő jelenik meg. Célszerű ehhez a csoporthoz a Drupal telepítésekor létrehozott felhasználót (admint) is hozzáadni, ugyanis az FCKeditor nem jogosultság, hanem csoporttagság alapján dönti el, megjelenjen-e vagy sem.
3. A http://example.com/?q=admin/settings/filters címen be kell állítani a beviteli formát. Két lehetőségünk van: vagy mindenkinek, aki FCKeditort használhat, bekapcsoljuk a Full HTML módot, vagy beállítjuk a Filtered HTML módot, hogy elfogadja és kezelje az FCKeditor által használt elemeket. Mi ez utóbbit szoktuk használni: az alapértelmezett <a> <em> <strong> <cite> <code> <ul> <ol> <li> <dl> <dt> <dd> lista helyett a <a> <p> <span> <div> <h1> <h2> <h3> <h4> <h5> <h6> <img> <map> <area> <hr> <br> <br /> <ul> <ol> <li> <dl> <dt> <dd> <table> <tr> <td> <em> <b> <u> <i> <strong> <font> <del> <ins> <sub> <sup> <quote> <blockquote> <pre> <address> <code> <cite> <embed> <object> <strike> <caption> listát használjuk.
4. A http://example.com/?q=admin/settings/fckeditor címen állíthatjuk be a modult. A legegyszerűbb a http://example.com/?q=admin/settings/fckeditor/edit/Advanced címen kezdeni a beállítást, az alábbiak szerint.
5. A Basic setup résznél győződjünk meg róla, hogy legalább egy csoportot kijelöltünk.
6. A Visibility settings résznél állíthatjuk be, hogy hol szeretnénk a hagyományos szerkesztő helyett FCKeditort látni. Ha mindenhol, akkor az alapbeállítások megfelelőek - de ez a legritkább esetben van így. Az itt található Minimum rows értékével (az alapértelmezés 1 sor) mutatja, hogy azon szerkesztőknél használhatunk FCKeditort, melyek mérete legalább a megadott számú sor. A Use inclusion or exclusion mode maradjon exclude, a Paths to exclude/include mezőre később visszatérünk.
7. Az Editor appearance résznél ki szoktuk kapcsolni a Show disable/enable rich text editor togglet (az egyszerű ügyfelet csak zavarja, ha több lehetőség van, mint amennyi feltétlenül szükséges). A Nyelvet célszerű fixen beállítani, azaz kikapcsolni az Auto-detect language-et: általában nem szokott az elvárható módon működni. A Toolbar legördülőt a gyári DrupalFiltered beállításról DrupalFull lehetőségre kapcsolva további gombok és vezérlők jelennek meg a szerkesztőben (betűméret, -típus, szín, stb.)
8. A Cleanup and output, CSS és File browser settings részben nem szoktunk állítgatni semmit. Utóbbihoz egyrészt úgyis engedélyezni kéne a megfelelő jogosultságot, másrészt jobban használható az IMCE modul erre a célra - és szépen be is épül az FCKeditorba. Ha netán a smink által beállított háttér nem lenne megfelelő szerkesztéskor, a CSS részben állítsuk át az Editor CSSt FCKeditor defaultra.

Finomhangolás

Ahogy fentebb már említettük, a Visibility settings részben található Paths to exclude/include mező segítségével beállíthatjuk, hogy mely Drupal oldalakon (elérési utakon) nem szeretnénk FCKeditort. Hasonlóan a Fields to exclude/include mező használatos egyedi mezők letiltására. Az admin felhasználó számára az FCKeditor minden többsoros szövegmező alá kiírja a mező nevét és elérési útját, ezzel is megkönnyítve az esetleges letiltásukat. Íme egy lista, hogy mely moduloknál milyen mezőket/elérési utakat érdemes letiltani (ezt a listát igyekszünk majd naprakészen tartani, ahogy újabb letiltásra érdemes mezőkkel/helyekkel találkozunk).

• Alaprendszer - mezők:
edit-log
• Views - elérési utak:
admin/build/views/*
• Update status - mezők:
edit-notify-emails
• Front Page - elérési utak:
admin/settings/front
• DHTML menus - elérési utak:
admin/settings/dhtml_menu
• Webform - mezők:
edit-webform-additional-validate
edit-webform-additional-submit
• Egyéb - mezők:
edit-code

A másik (magyar felületnél célszerű) finomhangolási lehetőség az ékezetek HTML entitásokkal való helyettesítésének kikapcsolása. Ehhez a sites/all/modules/fckeditor/fckeditor.config.js fájlban keressük meg a FCKConfig.ProcessHTMLEntities = true ; sort, és állítsuk át false-ra. A módosítások életbe lépéséhez nem elég a fájl mentése és az FCKeditort tartalmazó oldal újratöltése, sőt, néhány böngészőben a Shift+Reload sem: Firefox3-ban például a gyorsítótárat is törölni kell.

A harmadik finomhangolási lehetőség gombok ki/be kapcsolása. Ha például szükségünk volna a balra-középre-jobbra igazítás mellett sorkizárási lehetőségre is, a sites/all/modules/fckeditor/fckeditor.config.js fájlban keressük meg a DrupalFiltered eszköztárat, és a 'JustifyRight' után szúrjuk be a 'JustifyFull' szöveget is. A módosítások életbe léptetéséhez lásd az előző bekezdést. Bővebb leírás a dokumentációban található.