Fejlesztő környezet kialakítása

Ez a leírás egy wiki oldal. Aki hibát vagy hiányosságot talál és van szerkesztési joga, akkor csak bátran :-)
Akinek meg nincsen az küldjön be issue-t.
A leírás célja, hogy mindenki megkapja a szükséges információt ahhoz, hogy a lehető legrövidebb idő alatt be tudjon kapcsolódni a Drupal.hu megújítási munkálataiba.

Alapkövetelmények

Az itt leírt lépések végrehajtásához szükséges egy GitHub regisztráció és a /drupalhu/drupal.hu repó fork -olása.

A Drupal alapkövetelményeinek leírása megtalálható a hivatalos kézikönyvben

Jelen dokumentum nem tér ki a fő komponensek telepítésére és beállítására (Apache/Nginx, MySQL, PHP) Viszont ad némi irány mutatást az Apache Solr telepítéséhez és konfigurációjához, lásd lejjebb.

Környezet függő értékek

Mindenkinek egyedi a saját, jól megszokott munkakörnyezete. Éppen ezért elképzelhető, hogy az alábbi leírásban javasolt parancsok nem mindenkinél működnek.

Jelen dokumentum nem tér ki a különböző operációs rendszerek változataira (WinXp, Win7-8, OS X, *nix). A különbségeket mindenki kezelje a saját környezetének megfelelően.

A fájlrendszer útvonalakra, domain nevekre és egyebekre az alábbi álnevekkel hivatkozunk a leírás további részében:

GITHUB_USERNAME

Ez a te GitHub-os felhasználó neved.

GITHUB_USERNAME_LOWER

Ez a te GitHub-os felhasználó neved csupa kisbetűvel.

DOC_ROOT

Az a fájlrendszer útvonal, ami arra a könyvtárra mutat ami a git clone ... parancs futtatása után az index.php-t tartalmazza.
Például: ~/public_html/vhost/drupalhu.localhost/docroot

HTTP_HOST

Böngészőben ezt az URL-t kell beírni a weboldal megtekintéséhez. "http://" nélkül!
Például: drupalhu.localhost

DB_NAME

A választott MySQL adatbázis neve.
Például: drupalhu

HTTP szerver

A HTTP szerver konfigurációjában be kell állítani egy új virtualhost-ot, aminek DocumentRoot-ja az előbb kiklónozott kódbázisra mutat (DOC_ROOT). Elméletileg nem szükséges a virtualhost, de alkönyvtárban még senki nem próbálta, és könnyen lehet, hogy lesznek linkek amik nem működnek majd. Tehát javasol a virtualhost.

Adatbázis mentés

Le tudsz tölteni egy tisztított adatbázis dumpot, ami nem tartalmaz érzékeny adatokat. (Ha találsz benne jelezd nekünk, hogy törölni tudjuk.)

1. MySQL terminál megnyitása
   mysql
2. CREATE DATABASE DB_NAME;
3. MySQL terminál bezárása
   exit
4. A letöltött DB dump beimportálása
   mysql DB_NAME < path-to/dump.sql

Apache Solr szerver

A keresési funkciók életre keltéséhez szükség van egy Apache Solr szerver telepítésére is.
Részletes leírást a Solr telepítéséről és beállításáról a search_api modul README.txt állományában találsz. (@todo: néhány linkkel azért segítsünk)

A Drupal előkészítése

1. cd DOC_ROOT
2. Meg kell nézni, hogy a files és files/private könyvtárak léteznek-e, és hanem akkor létrehozni őket, és a HTTP szerver számára írási jogot adni.
3. A sites/default/settings.local.php létrehozása.
4. Az adatbázis kapcsolat beállítása.
   Valami ehhez hasonló lesz.

<?php
$databases = array(
  'default' => array(
    'default' => array(
      'driver' => 'mysql',
      'database' => 'DB_NAME',
      'username' => '',
      'password' => '',
      'host' => '127.0.0.1',
      'port' => '3306',
      'prefix' => '',
    ),
  ),
);
?>

1. cd DOC_ROOT/sites/default
2. drush rr
   Ha esetleg nem lenne telepítve Registry Rebuild, itt a remek alkalom, hogy megtedd!
3. drush cc all
4. drush user-password admin --password=1234
5. drush updatedb
6. drush pm-enable stage_file_proxy

Fejlesztői beállítások a settings.local.php -ben

<?php
$conf['reroute_email_enable'] = TRUE;
$conf['reroute_email_address'] = '[email protected]';

$conf['stage_file_proxy_origin'] = 'http://drupal.hu';
$conf['stage_file_proxy_use_imagecache_root'] = TRUE;
$conf['stage_file_proxy_hotlink'] = FALSE;

// Turn off the GoogleAnalytics.
$conf['googleanalytics_account'] = '';

// Admin menu client cache.
$conf['admin_menu_cache_client'] = TRUE;

// View UI configurations.
$conf['views_ui_show_advanced_help_warning'] = 0;
$conf['views_ui_show_listing_filters'] = 1;
$conf['views_ui_show_advanced_column'] = 1;
$conf['views_ui_show_sql_query'] = 1;

$conf['drupalhu_search_server_main_http_user'] = '';
$conf['drupalhu_search_server_main_http_pass'] = '';
$conf['drupalhu_search_server_main_host'] = '127.0.0.1';
$conf['drupalhu_search_server_main_port'] = '8983';
$conf['drupalhu_search_server_main_path'] = '/solr/SOLR_CORE_NAME';

// Enable CSS aggregation.
$conf['preprocess_css'] = 0;

// Enable JS aggregation.
$conf['preprocess_js'] = 0;

// Error level:
// - 0: None.
// - 1: Errors and warnings.
// - 2: All messages.
$conf['error_level'] = 2;

Első bejelentkezés

1. Bejelentkezés http://HTTP_HOST/user
2. Rendszer ellenőrzés http://HTTP_HOST/admin/reports/status
3. Search API - csak akkor érdekes, ha a kereséssel kapcsolatos dolgokon dolgoznál
   1. Beállítások http://HTTP_HOST/admin/config/search/search_api/server/ujsolr/edit
      1. Solr path = /solr/SOLR_CORE_NAME
      2. A Basic HTTP authentication fieldset-et ki kell nyitni és megnézni, hogy mi van benne, mert a böngésző hajlamos kitölteni, ami hibás működéshez vezethet.
      3. Beállítások mentése.
   2. Újra indexelés.
      1. http://HTTP_HOST/admin/config/search/search_api/index/tartalom/status
      2. http://HTTP_HOST/admin/config/search/search_api/index/hozzaszolas/status