Tento článok je pokračovaním článku Lokalizovaný dátum v cakePHP a preto je nevyhnutné si uvedený článok prečítať.

Cieľom tohto článku je ukázať, ako môžeme zobrazovať dátumy slovným spôsobom tak, ako to môžeme vidieť na tomto blogu.

1. krok – metóda pre zobrazenie dátumu

Do našej vytvorenej triedy DateHelper si pridáme nasledujúcu metódu

function timeAgoInWords($datetime_string, $format = DATE_FORMAT, $backwards = false)
{
        $datetime = $this->fromString($datetime_string);

        $in_seconds = $datetime;

        if ($backwards) {
                $diff = $in_seconds - time();
        } else {
                $diff = time() - $in_seconds;
        }

        $months = floor($diff / 2419200);
        $diff -= $months * 2419200;
        $weeks = floor($diff / 604800);
        $diff -= $weeks * 604800;
        $days = floor($diff / 86400);
        $diff -= $days * 86400;
        $hours = floor($diff / 3600);
        $diff -= $hours * 3600;
        $minutes = floor($diff / 60);
        $diff -= $minutes * 60;
        $seconds = $diff;

        if ($months > 0) {
                // over a month old, just show date (mm/dd/yyyy format)
                $relative_date = date($format, $in_seconds);
                $old = true;
        } else {
                $relative_date = '';
                $old = false;

                if ($weeks > 0) {
                        // weeks and days
                        $relative_date .= ($relative_date ? ', ' : '') . $weeks . ' ' . ($weeks > 1 ? __('DATE_WEEKS',true) : __('DATE_WEEK',true));
                        $relative_date .= $days > 0 ? ($relative_date ? ' '.__('DATE_SEPARATOR',true).' ' : '') . $days . ' ' . ($days > 1 ? __('DATE_DAYS',true) : __('DATE_DAY',true)) : '';
                } elseif ($days > 0) {
                        // days and hours
                        $relative_date .= ($relative_date ? ', ' : '') . $days . ' ' . ($days > 1 ? __('DATE_DAYS',true) : __('DATE_DAY',true));
                        $relative_date .= $hours > 0 ? ($relative_date ? ' '.__('DATE_SEPARATOR',true).' ' : '') . $hours . ' ' . ($hours > 1 ? __('DATE_HOURS',true) : __('DATE_HOUR',true)) : '';
                } elseif ($hours > 0) {
                        // hours and minutes
                        $relative_date .= ($relative_date ? ', ' : '') . $hours . ' ' . ($hours > 1 ? __('DATE_HOURS',true) : __('DATE_HOUR',true));
                        $relative_date .= $minutes > 0 ? ($relative_date ? ' '.__('DATE_SEPARATOR',true).' ' : '') . $minutes . ' ' . ($minutes > 1 ? __('DATE_MINUTES',true) : __('DATE_MINUTE',true)) : '';
                } elseif ($minutes > 0) {
                        // minutes only
                        $relative_date .= ($relative_date ? ', ' : '') . $minutes . ' ' . ($minutes > 1 ? __('DATE_MINUTES',true) : __('DATE_MINUTE',true));
                } else {
                        // seconds only
                        $relative_date .= ($relative_date ? ', ' : '') . $seconds . ' ' . ($seconds != 1 ? __('DATE_SECOND',true) : __('DATE_SECONDS',true));
                }
        }

        $ret = $relative_date;
        // show relative date and add proper verbiage
        if (!$backwards && !$old) {
                $ret = __('DATE_AGO',true) . ' ' . $ret;
        }
        return $this->output($ret);
}

2. krok – lokalizovaný popis dátumu

Ďalším krokom je umiestniť preklady popisov dátumu do nášho jazykového súboru app/locale/tvoj_ja­zyk/LC_MESSAGES/de­fault.po

msgid "DATE_TODAY"
msgstr "dnes"

msgid "DATE_YESTERDAY"
msgstr "včera"

msgid "DATE_WEEKS"
msgstr "týždňami"

msgid "DATE_WEEK"
msgstr "týždňom"

msgid "DATE_SEPARATOR"
msgstr "a"

msgid "DATE_DAYS"
msgstr "dňami"

msgid "DATE_DAY"
msgstr "dňom"

msgid "DATE_HOURS"
msgstr "hodinami"

msgid "DATE_HOUR"
msgstr "hodinou"

msgid "DATE_MINUTES"
msgstr "minútami"

msgid "DATE_MINUTE"
msgstr "minútou"

msgid "DATE_SECOND"
msgstr "sekundov"

msgid "DATE_SECONDS"
msgstr "sekundami"

msgid "DATE_AGO"
msgstr "pred"

3. krok – zobrazujeme lokalizovaný dátum

Posledný krok, aby sme mohli náš lokalizovaný dátum zobraziť je umiestniť nasledujúci kód do controlleru, ktorý bude používať náš helper. Pre náš príklad si to môžeme vložiť do súboru app/controller­s/articles_con­trollers.php

var $helpers = array("Date");

Následne môžeme v našich view súboroch zobrazovať dátum napríklad takýmto spôsobom

echo $date -> timeAgoInWords($article["create"]);

Dúfam, že vám bol tento mini seriál aspoň trochu užitočný a dúfam, že sa v budúcnosti dočkáme natívnej podpory lokalizovaného dátumu priamo v CakePHP.

Rád uvítam vaše námety a pripomienky v diskusii k článku.

Kniha hovorí, ako už z názvu napovedá o prístupnosti webu pre všetkých bez akéhokoľvek rozdielu.

V knihe nájdete veľmi zaujímavé témy, ako správne navrhovať stránky, používať farby, tabuľky, obrázky, ako navrhovať čiteľné a prehľadné formuláre, ako navrhovať stránky, aby sa na nich dalo jednoducho a zmysluplne orientovať a mnoho iného.

Myslím si, že rozhodne kniha stojí za prečítanie a rozhodne vás obohatí o mnohé zaujímavé poznatky z prístupnosti.

Kniha je písaná jednoduchým jazykom a veľmi príjemne sa číta. Mne stačilo pár dní a viac než 300 stránkovú knihu som mal prečítanú.

Bližšie informácie nájdete na adrese venovanej prístupnosti na webe

1. krok: vytvorenie funkcií v javascripte

Najprv si vytvoríme javascriptový súbor, ktorý nazveme texy.js a umiestnime ho do adresára

app/webroot/js/texy.js

do tohto súboru umiestnime nasledujúci kód

function help_texy(code){

        document.getElementById('hhhh').innerHTML = code;

}

// http://www.alexking.org - LGPL
function insertAtCursor(myField, prefix, postfix) {
        var re = new RegExp("^(.*\\S)(\\s*)$");
  myField.focus();
  //IE support
  if (document.selection) {
    sel = document.selection.createRange();
                var selection = sel.text;
                var wasEmpty = (selection == "");
                var space = "";
                if (!wasEmpty) {
                        var matches = selection.match(re);
                        if (matches) {
                                selection = RegExp.$1;
                                space = RegExp.$2;
                        }
                }
    sel.text = prefix+selection+postfix+space;
                sel.collapse(false);
                if (wasEmpty) {
                        sel.moveEnd('character',-(prefix.length+1))
                }
                sel.select();
  }
  //MOZILLA/NETSCAPE support
  else {
                if (myField.selectionStart || myField.selectionStart == '0') {
                        var startPos = myField.selectionStart;
                        var endPos = myField.selectionEnd;
                        var selection = myField.value.substring(startPos, endPos);
                        var wasEmpty = (startPos == endPos);
                        var space = "";
                        if (!wasEmpty) {
                                var matches = selection.match(re);
                                if (matches) {
                                        selection = RegExp.$1;
                                        space = RegExp.$2;
                                }
                        }
                        myField.value = myField.value.substring(0, startPos)
                                                                                + prefix+selection+postfix+space
                                                                                + myField.value.substring(endPos, myField.value.length);

                        var newPosition;
                        if (wasEmpty) {
                                newPosition = startPos+prefix.length;
                        } else {
                                newPosition = startPos+prefix.length+selection.length+postfix.length+space.length;
                        }
                        myField.setSelectionRange(newPosition, newPosition);
                } else {
                        myField.value += prefix+postfix;
                        myField.setSelectionRange(startPos+prefix.length, startPos+prefix.length);
                }
        }
}

Na vysvetlenie kódu vyššie. Prvá funkcia nazvaná help_texy() nám umožní zobraziť nápovedu pri prechode myšou nad daným formátovacím tlačítkom.

Druhá funkcia nazvaná insertAtCursor() nám umožní efektívne formátovať text vkladaním direktív texy. Autorom tejto funkcie je Alex King Táto funkcia nám okrem iného umožňuje označiť text, stlačiť pri označenom texte formátovacie tlačítko a označený text sa celý zformátuje (ukážku funkčnosti môžeme vidieť napríklad v diskusii pod týmto článkom).

2. krok: vloženie javascript súboru

Javascript súbor texy.js máme vytvorený a teraz nám stačí načítať tento súbor v nášom layoute. Do súboru app/views/lay­outs/default.ctp vložíme nasledovný kód

<?php echo $javascript -> link('texy.js'); ?>

3. krok: helper pre formátovacie tlačítka

Posledným krokom je vytvorenie helperu pre formátovacie tlačítka. Vytvoríme súbor app/views/hel­pers/texy.php do ktorého umiestníme nasledujúci kód

class TexyHelper extends AppHelper
{
        function createMenuBar()
        {
                $output = '<input type="button" onclick="insertAtCursor(document.commentsAddForm.CommentText, \'**\', \'**\')" onmousemove="help_bbcode(\''.__("TEXY_B",true).'\')" value="b"/>
                <input type="button" onclick="insertAtCursor(document.commentsAddForm.CommentText, \'//\', \'//\')" onmousemove="help_bbcode(\''.__("TEXY_I",true).'\')" value="i"/>
                <input type="button" onclick="insertAtCursor(document.commentsAddForm.CommentText, \'/---code\n\', \'\n\\\---\')" onmousemove="help_bbcode(\''.__("TEXY_CODE",true).'\')" value="code"/>
                <input type="button" onclick="insertAtCursor(document.commentsAddForm.CommentText, \'"'.__("TEXY_URL_NAME",true).'":\', \'\')" onmousemove="help_bbcode(\''.__("TEXY_URL",true).'\')" value="link"/>

                <input type="button" onclick="insertAtCursor(document.commentsAddForm.CommentText, \'"'.__("TEXY_EMAIL_NAME",true).'":\', \'\')" onmousemove="help_bbcode(\''.__("TEXY_EMAIL",true).'\')" value="email"/>
                <input type="button" onclick="insertAtCursor(document.commentsAddForm.CommentText, \'\', \' .{color:red}\')" onmousemove="help_bbcode(\''.__("TEXY_COLOR",true).'\')" value="color"/>
                <input type="button" onclick="insertAtCursor(document.commentsAddForm.CommentText, \'\', \' .<>\')" onmousemove="help_bbcode(\''.__("TEXY_CENTER",true).'\')" value="center"/>
                <input type="button" onclick="insertAtCursor(document.commentsAddForm.CommentText, \'\', \' .>\')" onmousemove="help_bbcode(\''.__("TEXY_RIGHT",true).'\')" value="right"/>';

                return $this -> output($output);
        }
}

Do súboru app/app_contro­ller.php vložíme kód

var $helpers = array('Texy');

Ešte nesmieme zabudnúť pridať do súboru app/locale/tvoj_ja­zyk/LC_MESSAGES/de­fault.po nasledujúce texty pre preklad

msgid "TEXY_B"
msgstr "Hrubý text: **hrubý text**"

msgid "TEXY_CODE"
msgstr "Kód: /---code kód v programovacom jazyku \\\\\\---"

msgid "TEXY_I"
msgstr "Šikmé písmo: //šikmý text//"

msgid "TEXY_URL"
msgstr "Vložiť odkaz: "názov odkazu":http://www.odkaz.sk"

msgid "TEXY_URL_NAME"
msgstr "názov odkazu"

msgid "TEXY_EMAIL"
msgstr "Vložiť odkaz: "názov email adresy":email@email.sk"

msgid "TEXY_EMAIL_NAME"
msgstr "názov email adresy"

msgid "TEXY_COLOR"
msgstr "Farba textu: farebny text .{color:farba}"

msgid "TEXY_CENTER"
msgstr "Zarovnanie textu na stred: text .<>"

msgid "TEXY_RIGHT"
msgstr "Zarovnanie textu napravo: text .>"

msgid "TEXY_HELP_TEXT"
msgstr "Tip: vyššie uvedenými tlačítkami môžete efektívne formátovať text"

Týmto máme všetky potrebné kódy vytvorené a môžeme do nášho view zakomponovať formátovacie tlačítka pre texy tak, ako to môžeme vidieť v diskusii k tomuto článku.

Stačí nám zavolať v ľubovoľnom view súbore nasledovný kód

<? echo $texy -> createMenuBar(); ?>

Ak chceme zobraziť nápovedu k jednotlivým tlačítkam, musíme vložiť do nášho view súboru nasledovný kód

<div id="hhhh"><? __('TEXY_HELP_TEXT'); ?></div>

Vaše námety a pripomienky rád uvítam v diskusii k článku.

PHP Development tools je IDE založené na vývojom prostredí Eclipse a poskytuje vývojárom PHP vynikajúce nástroje pre efektívnu prácu v tomtom jazyku.

Okrem množstva funkcií stojí za zmienku aj vstavaný debugger.

Výhodou tohto IDE je jeho multiplatformnosť, kedže je postavené na Jave.

Bližšie informácie nájdete na stránkach Zend alebo priamo na stránkach projektu

Najprv si musíme stiahnuť zdrojové kódy Texy, ktoré nájdeme na oficiálnej stránke Texy. V dobe písania článku je aktuálna verzia Texy 2 beta.

Po stiahnutí archívu nám stačí súbor texy.compact.php, čo je kompletné texy v jednom súbore.

Súbor texy.compact.php rozbalíme do adresára app/vendors/texy/

Následne vytvoríme súbor app/views/hel­pers/texy.php do ktorého umiestníme nasledujúci kód

vendor('texy'.DS.'texy.compact');

class TexyHelper extends AppHelper {

  function show($string)
  {
     $texy = new texy();

     $output = $texy -> process($string);

     return $this -> output($output);
  }

}

Posledný krok je povoliť používanie helperu texy v našich view súboroch a to zapísaním nasledovného kódu do súboru app/app_contro­ller.php

var $helpers = array("Texy");

Týmto máme všetko hotové a pri zobrazení napríklad príspevkov v diskusii môžeme volať nasledovný kód

echo $texy -> show($article["Comment"]["text"]);

V budúcej časti sa môžeme tešiť na článok o formátovacích tlačítkach k texy, ktoré nám uľahčia formátovanie príspevkov v diskusiách.