Systém souborů

Metoda stahování

Veřejně (veřejný přístup)

Adresa odkazu u souborů ukazuje přímo na místo, kde jsou soubory na serveru umístěny.

Neveřejně (neveřejný přístup)

Umístění souborů na serveru není možné zjistit přímo z adresy odkazu, protože do adres odkazů na soubor vkládá Drupal automaticky proměnnou system.

Výhody:

• umožňuje kontrolovat přístup ke stahovaným souborům (např. je možné zjišťovat počet stažení příloh)

Při umístění souborů mimo veřejný prostor webu je většinou nutné požádat poskytovatele webhostingu o posunutí Open_basedir restrikce.

Nastavení

1. Přejděte do admin/config/media/file-system (Konfigurace, Systém souborů) a zvolte výchozí způsob stahování.
2. Nastavte cestu k souborovému systému a dočasnému adresáři:
   1. Veřejná metoda stahování (veřejný přístup)
      1. Jednoduchý web (výchozí nastavení):
         • Cesta k veřejnému souborovému systému: sites/default/files
         • Cesta k neveřejnému souborovému systému: sites/default/private/files
         • Dočasný adresář: /tmp nebo sites/default/private/tmp
      2. Multisite web:
         • Cesta k veřejnému souborovému systému: sites/adresa.webu/files
         • Cesta k neveřejnému souborovému systému: sites/adresa.webu/private/files
         • Dočasný adresář: /tmp nebo sites/adresa.webu/private/tmp
   2. Neveřejná metoda stahování (neveřejný přístup):
      1. Jednoduchý web:
         1. Adresáře private/files a tmp jsou umístěny na veřejném místě webhostingu, ale znepřístupněny nastavení souboru .htaccess
            • Cesta k neveřejnému souborovému systému: sites/default/private/files
              • do souboru private/files/.htaccess doplňte
                

                Deny from all

                dle nastavení serveru je někdy nutné zakomentovat

                #Options None
                #Options +FollowSymLinks
                

              • pokud v neveřejném systému souborů chcete povolit přístup do nějakého adresáře např. private/files/languages/, vložte do něj soubor .htaccess obsahující
                

                Order Deny,Allow

            • Dočasný adresář: /tmp nebo sites/default/private/tmp
         2. Adresáře private/files a tmp jsou umístěny na neveřejném místě webhostingu
            • Cesta k neveřejnému souborovému systému: dle umístění na serveru
            • Dočasný adresář: dle umístění na serveru
      2. Multisite web:
         1. Adresáře private/files a tmp jsou umístěny na veřejném místě webhostingu, ale znepřístupněny nastavení souboru .htaccess
            • Cesta k neveřejnému souborovému systému: sites/adrese.webu/private/files
              • do souboru private/files/.htaccess doplňte
                

                Deny from all

              • pokud v neveřejném systému souborů chcete povolit přístup do nějakého adresáře např. private/files/languages/, vložte do něj soubor .htaccess obsahující
                

                Order Deny,Allow

            • Dočasný adresář: /tmp nebo sites/adresa.webu/private/tmp
         2. Adresáře private/files a tmp jsou umístěny na neveřejném místě webhostingu
            • Cesta k souborovému systému: dle umístění na serveru
            • Dočasný adresář: dle umístění na serveru

Úpravy 

Pokdu jste již na web vložili nějaké soubory (přílohy, obrázky atd.), metodu stahování již neměňte!

Veřejně (veřejný přístup)

Pokud potřebujete změnit umístění adresáře files je třeba upravit i cesty v databázových tabulkách files, node_revisions, users a variable.

Datum a čas

1. V admin/config/regional/date-time/locale/cs/edit (Konfigurace, Datum a čas, Lokalizovat, Čeština) upravte formáty:
   • Dlouhý: Úterý, 15. Únor 2011 – 23:43
     • l, d. F Y – H:i (vlastní formát s dlouhou pomlčkou)
   • Střední: 15. Únor 2011 – 23:43
     • d. F Y – H:i (vlastní formát s dlouhou pomlčkou)
   • Krátký: 15. 02. 2011 – 23:43
     • d. m. Y – H:i (vlastní formát s dlouhou pomlčkou)

Lokalizace

1. V admin/modules (Moduly) povolte modul Locale.
2. V admin/config/regional/language (Konfigurace, Jazyky) zvolte výchozí jazyk.
3. V admin/config/regional/translate/import (Konfigurace, Překlad rozhraní, Import) je možné importovat .po soubory překladů.
4. V admin/config/regional/translate/translate (Konfigurace, Překlad rozhraní, Přeložit) je možné nepřeložené výrazy vyhledat a přeložit.

Nabízí se dva různé způsoby překladu vícejazyčného obsahu:

1. Původní způsob po celých uzlech viz modul Content translation.
2. Nový způsob po samostatnch entitách viz modul Entity translation.

Odkazy

• Localize Drupal – překlady jádra a modulů
• Český překlad Drupalu – slovníček a standardy pro překlady (časem by měl být obsah webu převeden na Localize Drupal)

Poznámka:
Příloha obsahuje oficiální překlady jádra sloučené do jediného souboru.

Cron

Některé moduly vyžadují službu cron. Zvolte si proto jednu z následujících možností:

Vestavěný Cron

Je spouštěn na základě návštěv uživatelů webu. V admin/config/system/cron (Konfigurace, Cron) je možné nastavit pravidelnost opakování.

Webhosting

Většina poskytovatelů nabízí zapnutí služby cron v administraci webhostingu. Po nastavení této služby vypněte spouštění vestavěného cronu v konfiguraci Drupalu.

Poormanscron

Použijte modul Drupalu s názvem Poormanscron.

WebCron

Zaregistrujte se na stránkách www.webcron.org a vytvořte si novou úlohu pro Váš web.

Server

Spouštění každých 30 minut

Do souboru /etc/crontab vložte (YOURKEY je možné zjistit v admin/reports/status (Logy, Hlášení stavu)

0,30 * * * * root /usr/bin/wget -O - -q http://example.com/cron.php?cron_key=YOURKEY

Spouštění každou hodinu

Do souboru /etc/crontab vložte

0 * * * * root /usr/bin/wget -O - -q http://example.com/cron.php?cron_key=YOURKEY

Jiný způsob:

1. Pro spouštění skriptu cron.php jednou za hodinu vytvořte v /etc/cron.hourly soubor s názvem např. script a oprávněním:
   

   Oprávnění souboru script

   	Čtení	Zápis	Spouštění
   Vlastník	Ano	Ano	Ano
   Skupina	Ano	Ne	Ano
   Ostatni	Ano	Ne	Ano

2. Do souboru vložte níže uvedené řádky a upravte adresu Vašeho webu:
   

   #!/bin/sh
   /usr/bin/wget -O - -q http://example.com/cron.php?cron_key=YOURKEY

   Pokud máte přístup k serveru omezen pouze na některé IP adresy, je vhodné příkazu wget nařídit použití lokálního rozhraní:

   #!/bin/sh
   /usr/bin/wget -O - -q --bind-address=127.0.0.1
    http://example.com/cron.php?cron_key=YOURKEY

PHP

1. Pro spouštění cronu pomocí PHP vytvořte soubor např. script.php s oprávněním:
   

   Oprávnění souboru script.php

   	Čtení	Zápis	Spouštění
   Vlastník	Ano	Ano	Ano
   Skupina	Ne	Ne	Ne
   Ostatni	Ne	Ne	Ne

2. Do souboru vložte níže uvedené řádky a upravte adresu Vašeho webu:
   

   <?php
     require('http://example.com/cron.php?cron_key=YOURKEY');
   ?>

   nebo (záleži na webhostingu)

   <?php
     $spustcron = file_get_contents('http://example.com/cron.php?cron_key=YOURKEY');
     echo $spustcron;
   ?>

Windows

Configuring cron jobs on Windows

Toolkit pro práci s obrázky

V admin/config/media/image-toolkit (Konfigurace, Toolkit pro práci s obrázky) nastavte kvalitu JPEG obrázků na 80 %.

Vstupní formáty

V admin/config/content/formats (Konfigurace, Formáty textu) určuje první řádek výchozí filtr:

• v nastavení filtru Full HTML povolte uživatelské role s oprávněním plné editace HTML obsahu (např. vytváření a úprava tabulek, flash animace atd.)
  • Role: administrator
• Filtered HTML
  • tento vstupní formát odstraňuje nepovolené (X)HTML značky a všechny atributy style
  • v nastavení filtru Limit povolených HTML značek můžete upravit Povolené HTML značky:
    

    <a> <p> <span> <div> <h3> <h4> <h5> <h6> <img> <hr> <br> <br /> <ul> <ol> <li> <dl> <dt> <dd> <em> <strong> <del> <ins> <sub> <sup> <quote> <blockquote> <pre> <address> <code> <cite>

  • Role: přihlášený uživatel, administrator
• Plain text
  • Role: všechny
• další vstupní formáty je možné vytvořit pomocí modulů:
  • PHP filter
  • WYSIWYG Filter – jednoduchá installace, nevyžaduje knihovny třetích stran
  • HTML Purifier – populární, mocný, ale může být pomalý
  • htmLawed – méně populární

Pokud používáte modul CKEditor (FCKeditor) je doporučeno pro lepší kontrolu nad konci řádků vypnout u všech vstupních formátů filtr Převést odřádkování do HTML (tj. <br> a <p>).

Vzhled

1. V admin/appearance (Vzhled) je možné určit výchozí a dostupná témata.
2. Více témat vzhledu je možné získat na http://drupal.org/project/Themes (většinu z nich si můžete prohlédnou na Theme Garden).
   1. Témata vzhledu umísťujte do adresáře sites/all/themes/. Toto umístění je vhodnější pro případný upgrade systému na nvou verzi. Navíc zde uvístěná témata vzhledu jsou společná pro všechny subdomény (multisite web).
3. Výchozí nastavení témat je možné upravit v admin/appearance/settings (Vzhled, Nastavení).

Primární odkazy

1. V admin/build/menu-customize/primary-links (Administrace, Prvky webu, Menu, Primární odkazy) je možné vytvářet a upravovat primární odkazy např.:
   • Nadpis odkazu menu: Přihlášení
   • Cesta: user

Bloky

Bloky sdružují obsah, který lze na stránce volně přemisťovat:

• v admin/structure/block (Struktura, Bloky) je možné upravovat rozmístění a nastavení jednotlivých bloků
• pokud si omylem vypnete blok pro přihlášení je možné se přihlásit zadáním adresy:
  • http://vase-domena/?q=user nebo http://vase-domena/user (pokud máte zapnutá čistá URL)

Tip: pro statistiky stránek, reklamu atd. je vhodné vytvořit samostatné bloky (nevkládejte je přímo do používaného tématu vzhledu)

Obsah

Node (uzel, jednotka) je obecný objekt reprezentující libovolný obsah. Každý node má jedinečné číslo (nid), verzi (vid), metadata, název (title) a obsah (většinou body).

Výchozí hodnoty pro jednotlivé typy obsahu

V admin/structure/types (Struktura, Typy obsahu) je možné nastavit výchozí hodnoty pro jednotlivé typy obsahu:

• popisek pro pole nadpis
• zobrazovaní na titulní straně
• nastavení komentářů
  • nezobrazovat formulář pro odpověď na stránce s komentáři
• nastavení výchozí pozice menu při zadávání nového obsahu

Titulní strana

V admin/config/system/site-information (Konfigurace, Informace o webu) je možné upravit:

• počet příspěvků na úvodní stránce
• výchozí titulní stranu

Informace o revizi

Při vytváření obsahu můžete pomocí revizí vytvářet různé verze (ukládat historii) stejného obsahu a sledovat rozdíly mezi jednotlivými verzemi.

Uživatelé

1. V admin/people (Uživatelé):
   • upravte nastavení vlastního účtu (1. vytvořený účet nemá žádná omezení):
   • obrázek uživatele
   • časová zóna
     • můžete vytvořit účet pro webmastra (1. vytvořený účet bez omezení používat jen pokud je to nutné)
     • v případě potřeby přidejte další uživatele
2. V admin/people/permissions/roles (Uživatelé, Role) můžete upravovat uživatelské role, např. vytvořit roli webmaster.
3. V admin/people/permissions (Uživatelé, Oprávnění) je možné upravovat oprávnění uživatelských rolí.

Uživatelské nastavení

V admin/config/people/accounts (Konfigurace, Nastavení účtu) je možné nastavit způsob registrace, podpisy, podporu obrázků uživatelů a upozorňovací e-maily:

• můžete povolit podpisy
• podpora obrázků uživatelů:
  • adresář pro obrázky: pictures/users
  • můžete upravit texty e-mailů

Zobrazení autora

V admin/structure/types (Struktura, Typy obsahu) je možné zvolit u kterého typu obsahu se bude zobrazovat autor (případně i jeho obrázek). Viz sekce Nastavení zobrazení.

Čistá URL

Viz nastavení modulu Path.

Menu

Viz nastavení modulu Menu.

Cookie

Pokud v souboru /sites/default/settings.php odkomentujete níže uvedenou proměnnou, může být uživatel přihlášen při přechodu mezi všemi doménami multisite webu.

$cookie_domain = 'example.com';

Výkon

V admin/config/development/performance (Konfigurace, Výkon) je možné nastavit:

• cache stránek pro anonymní uživatele
  • při zapnutí se nepřihlášeným uživatelům mohou zobrazovat neaktuální informace (např. u modulů Coundown a Event) –  řešení nabízí např. modul CacheExclude
  • při úpravách tématu vzhledu je vhodné cache stránek dočasně vypnout
  • nepovolujte pokud http hlavičky vracejí údaj Transfer-Encoding: gzip (deflate) – v tomto případě provádí komprimaci již server
• optimalizaci přenosu dat (pouze pokud máte nastaven systém souborů na veřejný)
  

Výkon Drupalu je možné zvýšit moduly:

• Ad memcache
• Cache Router
• Memcache API and Integration
• Path Cache
• Authcache
• Advanced cache

Výkon web serveru je možné zvýšit:

• použitím PHP op-code cache / accelerators (XCache, APC, eAccelerator, Alternative PHP Cache, Zend Optimizer, ionCube PHP Accelerator, Turck MMCache, Nusphere PhpExpress atd.)
• konfigurací dedikovaného web serveru pro statické stránky
• instalací PHP memcache (debian memcached)
• replikací MySQL databází pro čtení (více slave strojů), pro čtecí servery pak použijte load-balencery

.info

Konfigurační soubor .info (en) obsahuje základní informace a je vyžadován u každého tématu vzhledu. Název souboru musí být shodný s názvem adresáře.

Soubor musí obsahovat klíče:

name = Moje vlastní téma vzhledu
core = 6.x

Příklad:

name = Moje vlastní téma vzhledu
description = Popis tématu<br /><a href="http://tomas.dankovi.info/">Tomáš Daněk</a>
core = 6.x
engine = phptemplate
stylesheets[all][] = styles/all.css
stylesheets[screen, projection][] = styles/layout.css
stylesheets[screen, projection][] = styles/decoration.css
stylesheets[screen, projection][] = styles/modules.css
stylesheets[screen, projection][] = styles/fckeditor.css
stylesheets[print][] = styles/print.css

Další regiony viz regions.

html.tpl.php

Soubor modules/system/html.tpl.php obsahuje základní HTML strukturu stránky.

page.tpl.php

Soubor modules/system/page.tpl.php obsahuje šablonu stránky.

Poznámka:
Pomocí snippetů můžete např. zobrazit uvítání uživatele, nebo upozornit na to, že uživatel ještě není registrován. 

template.php

Šablona template.php (en) umožňuje předefinovat výchozí a vytvářet vlastních funkce.

Odpovídající funkce je možné vyhledat na stránkce Default theme implementations (en).

Potlačení CSS souborů definovaných jádrem a moduly

Téma vzheldu může nahradit CSS soubory definované jádrem a moduly přidáním stylopisu stejného jména a použitím funkce drupal_add_css(). Toto umožňuje tématům potlačit veškeré CSS soubory pokud je to nutné.

Například pokud chcete styl modules/system/system-menus.css definovaný jádrem nahradit (potlačit pro určitá média) vlastním:

1. V používaném tématu vzhledu vytvořte např. v adresáři styles soubor system-menus.css s požadovanými styly.
2. V používaném tématu vzhledu vytvořte (upravte) souboru template.php, do kterého vložte:
   

   <?php
     drupal_add_css(path_to_theme() .'/styles/system-menus.css', 'theme', 'screen, projection', TRUE);
   ?>
   

Výše uvedený příklad se načte pouze pro dané téma, tj. nenačte se pro případná podtémata. Pokud potřebujete používat přepis stylu i v podtématech přidejte jej přímo do .info souboru.

/**
 * Generates IE CSS links for LTR and RTL languages.
 */
function phptemplate_get_ie_styles() {
  global $language;
  $iecss = "\n";
  $iecss .= '<!--[if (lte IE 7)&(gte IE 5)]>'."\n  ";
  $iecss .= '<link type="text/css" rel="stylesheet" media="screen,
   projection" href="'. base_path() . path_to_theme()
   .'/styles/ie-7.css" />'."\n  ";
  if (defined('LANGUAGE_RTL') && $language->direction ==
   LANGUAGE_RTL) {
    $iecss .= '<link type="text/css" rel="stylesheet" media="screen,
     projection" href="'. base_path() . path_to_theme()
     .'/styles/ie-7-rtl.css" />'."\n  ";
  }
  $iecss .= '<![if lt IE 7]>'."\n    ";
  $iecss .= '<link type="text/css" rel="stylesheet" media="screen, 
   projection" href="'. base_path() . path_to_theme()
   .'/styles/ie-6.css" />'."\n    ";
  if (defined('LANGUAGE_RTL') && $language->direction ==
   LANGUAGE_RTL) {
    $iecss .= '<link type="text/css" rel="stylesheet" media="screen,
     projection" href="'. base_path() . path_to_theme()
      .'/styles/ie-6-rtl.css" />'."\n    ";
  }
  $iecss .= '<![if lt IE 6]>'."\n      ";
  $iecss .= '<link type="text/css" rel="stylesheet" media="screen,
   projection" href="'. base_path() . path_to_theme()
    .'/styles/ie-5.5.css" />'."\n      ";
  if (defined('LANGUAGE_RTL') && $language->direction ==
   LANGUAGE_RTL) {
    $iecss .= '<link type="text/css" rel="stylesheet" media="screen,
     projection" href="'. base_path() . path_to_theme()
     .'/styles/ie-5.5-rtl.css" />'."\n      ";
  }
  $iecss .= '<![if lt IE 5.5]>'."\n        ";
  $iecss .= '<link type="text/css" rel="stylesheet" media="screen, 
   projection" href="'. base_path() . path_to_theme()
   .'/styles/ie-5.css" />'."\n      ";
  if (defined('LANGUAGE_RTL') && $language->direction ==
   LANGUAGE_RTL) {
    $iecss .= "  ".'<link type="text/css" rel="stylesheet"
     media="screen, projection" href="'. base_path() .
      path_to_theme() .'/styles/ie-5-rtl.css" />'."\n      ";
  }
  $iecss .= '<![endif]>'."\n    ";
  $iecss .= '<![endif]>'."\n  ";
  $iecss .= '<![endif]>'."\n";
  $iecss .= '<![endif]-->'."\n";
  return $iecss;
}

/**
* Theme the way an 'all day' label will look.
*/
function phptemplate_date_all_day_label() {
  return '';
}

comment.tpl.php

Soubor comment.tpl.php obsahuje šablonu komentáře

Příklad:

<div class="comment2<?php print ($comment->new) ? ' comment-new' : ''; print ' '. $status; print ' '. $zebra; ?>">
  <div class="clear-block">
  <?php if ($submitted): ?>
    <span class="submitted"><?php print $submitted; ?></span>
  <?php endif; ?>
  <?php if ($comment->new) : ?>
    <span class="new"><?php print drupal_ucfirst($new) ?></span>
  <?php endif; ?>
  <?php print $picture ?>

    <h3><?php print $title ?></h3>
    <div class="content">
      <?php print $content ?>
      <?php
        if ($signature):
        // You can use the following to prevent double-display of signatures on old posts (converting Drupal 5 to Drupal 6)
        // if ($signature && $comment->cid > 3443): // The highest comment ID before upgrading to Drupal 6
      ?>

        <div class="user-signature clear-block">
          <div>—</div>
          <?php print $signature ?>

        </div>
      <?php endif; ?>

    </div>
  </div>
  <?php if ($links): ?>

    <div class="links"><?php print $links ?></div>
  <?php endif; ?>

</div>

maintenance-page.tpl.php

Vlastní vzhled webu v offline režimu.

1. V adresáři vlastního vzhledu vytvořte soubor maintenance-page.tpl.php např. zkopírováním souboru page.tpl.php.
2. V sites/default/settings.php odkomentujte (i záčátek a konec pole) a definujte téma pro offline režim např.:
   

   $conf = array(
     'maintenance_theme' => 'my-owns-theme'
   );

Úprava vzhledu modulu pomocí šablony .tpl.php

Bližší informace o šablonách naleznete v Template Suggestions.

Příklad upravy úvodní stránky:

• Drupal 7
  • page.tpl.php (základní šablona je vyžadována vždy )
  • page--front.tpl.php 
• Drupal 6
  • page.tpl.php (základní šablona je vyžadována vždy )
  • page-front.tpl.php 

Příklad změny vzhledu uživatelského profilu:

1. Z adresáře modules/user/ zkopírujte do svého tématu vzhledu soubor user-profile.tpl.php.
2. A admin/settings/performance (Administrace, Nastavení webu, Výkon) vyčistěte Cache.
3. Upravte zkopírovaný soubor user-profile.tpl.php dle potřeb.

CSS

Kaskádové styly (CSS)

Podpora jazyků s tokem textu zprava doleva

Kaskádové styly je možné vytvářet v párech. Ve stejném adresáři může být např. soubor style.css s výchozím určením pro tok textu zleva doprava (left to right) a style-rtl.css určený pro tok textu zprava doleva (right to left) např. pro Arabštinu, Hebrejštinu atd.

Soubor style-rtl.css může potlačit určené deklarace souboru style.css. Dle dohody jsou odlišnosti v toku textu označeny /* LTR */ komentářem v originálním souboru style.css, aby bylo jasné které deklarace je nutné modifikovat v souboru style-rtl.css (přehlednost při pozdějších úpravách).

Soubor style-rtl.css je uplatněn pouze v případě použití jazyka (zobrazení stránek) s tokem textu zprava doleva a potlačuje tak určené deklarace souboru style.css.

Příklad:

Výpis části souboru modules/system/defaults.css:

th {
  text-align: left; /* LTR */
  padding-right: 1em; /* LTR */
  border-bottom: 3px solid #ccc;
}

Výpis části souboru modules/system/defaults-rtl.css:

th {
  text-align: right;
  padding-right: inherit;
  padding-left: 1em;
}

Odvozený vzhled

Adresář se vzhledem může obsahovat několik odvozených (podobných) témat vzhledů.

1. V adresáři se vzhledem vytvořte požadovanou strukturu. Např.: adresář sub-themes a v něm adresář s názvem odvozeného vzhledu.
2. Při vytváření odvozeného vzhledu postupujte stejně jako při vytváření vlastního vzhledu (do adresáře s odvozeným vzhledem umisťujte soubory a adresáře), přičemž práci si ulehčíte tím, že budete vkládat pouze odlišné soubory od "základního" vzhledu.
3. Odvozený vzhled musí obsahovat alespoň soubor s příponou .info např. my-derived-theme.info.
4. Odvozený vzhled nesdílí theme-settings.php, logo, color a některá nastavení z .info souboru.

Příklad:

name = Odvozené téma vzhledu
description = Popis odvozeného tématu
core = 6.x
engine = phptemplate
base theme = nazev-zakladniho-tematu
stylesheets[screen, projection][] = styles/my-derived-styles.css

Název odvozeného tématu je uložen v proměnné $theme_key (hodí se např. při úpravách cest k obrázkům nebo pro třídy CSS):

<?php
  global $theme_key;
  print $theme_key;
?>

Doporučení

• každý z vícenásobných CSS selektorů psát na samostatný řádek 
• barevné nastavení vzhledu (barvy textů, pozadí, rámečků, stínů, obrázky na pozadí) psát do samostatného souboru např. color.css
• výchozí formátování HTML prvků psát do samostatného souboru např. html.css

drupal_get_breadcrumb

Popis

Získá odkazy drobečkové navigace pro aktuální stránku.

Definice

drupal_get_breadcrumb()

includes/common.inc, line 95

Výstup

Řetězec obsahující odkazy drobečkové navigace.

Příklad

Vlastní úprava drobečkové navigace:

<?php
  // if ($breadcrumb) print $breadcrumb;
  if ($breadcrumb) {
    $subtheme_start_page = "<a href=\"/views/news\"
      title=\"Úvodní stránka novinek\">Novinky</a>";
    $crumbs = drupal_get_breadcrumb();
    $home_page = array_shift($crumbs);
    array_unshift($crumbs, $home_page, $subtheme_start_page);
    print theme_breadcrumb($crumbs);
  }
?>

l

Popis

Formátuje vnitřní odkaz.

Funkce l správně manipuluje s odkazy, které mohou mít vytvořené aliasy a umožňuje upravovat jejich vlastnosti. Všechny vnitřní odkazy výstupů modulů by měly být generovány touto funkcí.

Definice

l($text, $path, $options = array())

includes/common.inc, řádek 1534

Níže jsou uvedena data pro Drupal 5!

Parametry

$text – text, který bude uzavřen v odkazu

Veškerý text, který může člověk přečíst a má být zobrazen na stránce by měl být zobrazován funkcí t().

$path – cesta odkazu

Může být externí nebo interní:

• při zadání úplné cesty bude považována za externí

• při zadání pouze cesty např. "admin/content/node" bude považována za interní

  • v tomto případě musí být systémovou cestou, aby mohl být generován případný alias pomocí funkce url()

$attributes – asociativní pole HTML atributů aplikovaných u elementu odkazu

$query – řetězec přidaný k odkazu za otazníkem (& parametr)

$fragment – identifikátor přidaný k odkazu (# kotva)

$absolute – vynutit absolutní odkaz začínající http:

Užitečné pro odkazy, které budou zobrazovány mimo web, jako například RSS kanály.

$html – podporovat HTML elementy

Hodnota TRUE je např. nutná pro zobrazení obrázku, jinak se místo obrázku zobrazí v odkazu prostý text (případně HTML entity).

Příklad

<?php
  l(t('Home'), 'node/', array('title' => $site_name, 'class' =>
   'link', 'id' => 'home'), NULL, NULL, FALSE, FALSE)
?>

Výstup

HTML řetězec obsahující odkaz na určenou cestu.

module_exists

Popis

Zjišťuje existenci modulu.

Definice

module_exists($module)

Parametr

$module – název modulu

Příklad

<?php if(module_exists('themer')) print ' '. themer_body_class(); ?>

Výstup

Logická hodnota TRUE, pokud je modul nainstalován a povolen.

t

Popis

Překládá řetězce do jazyka stránky nebo určeného jazyka.

Veškerý text, který může člověk přečíst a má být zobrazen na stránce by měl být zobrazován touto funkcí.

Definice

t($string, $args = array(), $langcode = NULL)

includes/common.inc, řádek 734

Parametry

$string – řetězec obsahující anglický text k přeložení.

$args – asociativní pole náhrad vytvořených po překladu. Všechny výskyty každého klíče v tomto poli jsou nahrazeny odpovídající hodnotou.

Klíče se speciálním významem:

• !variable – vloženo tak jak je
• @variable – převede čístý text do HTML (funkce check_plain)
• %variable – převede text do HTML a přidá formátovací element (funkce check_plain + theme_placeholder)

$langcode  – volitelný kód jazyka překladu odlišný od jazyka stránky

Výstup

Přeložený řetězec.

theme

Popis

Vrací nastylovaný výstup.

Příklad

<?php
  print theme('username', $node);
?>

theme_breadcrumb

Popis

Vrací nastylovanou drobečkovou navigaci.

Definice

theme_breadcrumb($breadcrumb)

includes/theme.inc, line 1226

Parametr

$breadcrumb – pole obsahující odkazy drobečkové navigace

Výstup

Řetězec obsahující drobečkovou navigaci.

Příklad

Vlastní úprava drobečkové navigace:

<?php
  // if ($breadcrumb) print $breadcrumb;
  if ($breadcrumb) {
    $subtheme_start_page = "<a href=\"/views/news\"
      title=\"Úvodní stránka novinek\">Novinky</a>";
    $crumbs = drupal_get_breadcrumb();
    $home_page = array_shift($crumbs);
    array_unshift($crumbs, $home_page, $subtheme_start_page);
    print theme_breadcrumb($crumbs);
  }
?>

theme_get_setting

Popis

Funkce získá nastavení z aktuálního tématu, která byla zadána v administraci webu.

Definice

theme_get_setting($setting_name, $refresh = FALSE))

includes/theme.inc, řádek 900

Parametry

$setting_name  – název nastavení, které má být získáno.

$refresh - zda obnovit nastavení cache.

Výstup

Hodnota požadovaného nastavení, NULL jestliže nastavení neexistuje.

Příklad

Zobrazení poslání webu jako meta informace v hlavičce stránky:

<?php
  $my_description = theme_get_setting('mission', false);
  if ($my_description) {
    print '<meta name="description" content="'. $my_description
     .'" />';
  }
?>

Přístup k databázi

Příklad zobrazení požadovaných údajů přímo z databáze:

<?php
  $sql = "SELECT title FROM node ORDER BY node.vid DESC LIMIT 10";
  $result = db_query($sql);
  while ($node = db_fetch_object($result)) {
    $output .= $node->title ." ";
  }
  return $output;
?>

Pro zobrazení je možné využít např. vestavěný PHP filtr obsahu nebo bloku.

Drupal 5

Snippety pro Drupal 5:

Porovnání modulů

Porovnání modulů upravujících drobečkovou navigaci

	Menu    1 (položka menu)      2 (položka menu)        Stránka	Kategorie    A (termín)      B (termín)        C (termín)	Kategorie    A (termín)      B (termín)        C (termín)          Článek
Drupal 6	Domů	Domů > A > B	Domů
Menu Breadcrumb	Domů > 1 > 2	Domů > A > B	Domů
Menu Trails (ruční zařazení kategorií )	Domů > 1 > 2 > Stránka (obsahuje název uzlu )	Domů > A > B	Domů > Kategorie > A (x) > B (x)
Node breadcrumb (málo možností nastavení pravidel )	Domů > 1 > 2	Domů > A > B	Domů (nastavená pravidla)
Taxonomy breadcrumb	Domů	Domů > A > B > C	Domů > A > B > C
Custom breadcrumb	Domů	Domů > A > B	Domů > Termín s nejvyšší váhou
Menu Breadcrumb + Taxonomy Breadcrumb	Domů	Domů > A > B > C	Domů > A > B > C
Menu Trails (bez ručního zařazení kategorií ) + Taxonomy Breadcrumb	Domů > 1 > 2 > Stránka (obsahuje název uzlu )	Domů > A > B > C	Domů > A > B > C

Vlastní moduly

• Creating modules (en)
• Programujeme pro Drupal bezpečně
• Writing secure code (en)
• Jak napsat vlastní modul pro Drupal

Vytvoření vlastního mini modulu

Minimální adresářová strura:

• my_module/
  • my_module.info
  • my_module.module (seznam vhodných hooks)
  • (my_module.install – použije se pouze při prvním zapnutí modulu)

Uvědomte se rozdíly mezi pojmy:

1. instalace modulu – aplikuje se pouze při prvním zapnutí modulu (např. vytovří tabulky v databázi)
2. zapnutí modulu – umožňuje modul používat a upravovat jeho nastavení
3. vypnutí modulu – zachová nastavené hodnoty
4. odinstalace modulu – umožňuje např. odstranit tabulky v databázi

Hooks

• Hooks
• Drupal Hooks Explained (en)
• Hook funkce

Hooks (háčky) můžeme chápat např. jako speciálně pojmenované PHP funkce. U vyhledané funkce nahraďte slovo hook_... za název modulu např. my_module_... např.:

hook_install() => my_module_install()
hook_enable() => my_module_enable()
hook_disable() => my_module_disable()

Bloky

Pro vytvořeního vlastního modulu, který má zobrazovat nějaký blok(y) jsou třeba minimálně dva hooky:

hook_block_info() => my_module_info()
hook_block_view() => my_module_view()

Při tvorbě bloku pomocí modulu je vhodné projít si demonstrační kód viz block_example.module.

Pro jednoduché uložení a získání dat je možné využít databázovou tabulku variable a funkce variable_set() a variable_get().

Globálné proměnné např. o uživateli je možné získat zápisem:

global $user;

Textové řetězce je nutné zapisovat do funkce t().

Formátování zdrojového kódu

• funkce se zapisují malými písmeny
• počátení { se píše za názvem funkce, ukončující } se píše smostatn na novém řádku
• pro odsazení se používají 2 znaky