Ebben a bejegyzésemben az előző bejegyzésemben bemutatott form beágyazási technika alapján készített plugint tenném közzé.

A plugin célja, hogy egyszerűsítsen a symfony beágyazási technikáján. Az egyszerűsítés viszont nem minden esetben jobb. Tehát ott érdemes használni, ahol nem visszük túlzásba a beágyazást. Ha túlságosan egyedi formára kívánjuk hozni, akkor előfordulhat hogy rengeteg módosítás helyett, célszerűbb teljesen tiszta lapról indulni. Akkor pedig az előző bejegyzésem nagyobb segítség, mint ez a plugin.
A plugin használatának nagyon fontos feltétele, hogy a kapcsolt táblák 1:N kapcsolatban legyenek az adatbázis szerint is. Tehát a beágyazandó táblában legyen meg az idegen kulcs!

Hozzávalók:
A plugin itt található
sfJqueryReloadedPlugin
CakePHP set osztálya, a symfonysított verziót ide tettem fel.

A plugin telepítése:

1. Miután létrehoztuk a projektünket, a plugin könyvtárba csomagoljuk ki plugint
2. Engedélyezzük a az apps/config/settings.yml fájlban:

   all:
     enabled_modules:        [default, tlsysEmbedderHelper, stb]
   

   Erre azért van szükség, mert az ajaxos hívást kiszolgáló action a pluginba került. Így azt sem kell állandóan újra és újra megírni.

3. A lib/form/BaseFormPropel.class.php származtatása a pluginnban talalhato tlsysEmbedderFormból

   abstract class BaseFormPropel extends tlsysEmbedderForm
   

4. A szükséges formokkban értéket kell adni a $tlsysEmbeddedForms protected változónak. Egy példa az előző bejegyzésemben található OsztalyFormra.

   class OsztalyForm extends BaseOsztalyForm
   {
     # meg kell adni a beágyazni szándékozott osztály nevét, egyes és többesszámban
     # a többesszám az, ahogy a propel hivatkozik rá
     protected $tlsysEmbeddedForms = array(array('singular'=>'Tanulo', 'plural'=>'Tanulos'));
     public function configure()
     {
     }
   }
   

Ezzel a 4 lépéssel ugyanazt értük el, mint az előző bejegyzésemben található litániával.

A bemutató alkalmazás innen tölthető le

A symfony beágyazott (embedded) form megoldásáról szóló kis szösszenet kerül ide.
A segítségével két, master-detail kapcsolatban álló tábla egyidejű módosítását lehet megvalósítani.

Itt is az első leírásban létrehozott sandbox projektünket fogjuk átszerkeszteni.

Tehát állítsuk be a config könyvtárban lévő adatbázisokhoz tartozó fájlokat (propel.ini és databases.yml) az előzőleg létrehozott sandbox adatbázisra. Majd szerkesszük meg a config/schema.yml fájlt:

propel:
  _attributes:
    package: lib.model
    defaultIdMethod: native
  osztaly:
    _attributes: { phpName: Osztaly }
    id: { phpName: Id, type: INTEGER, size: '11', primaryKey: true, autoIncrement: true, required: true }
    kod: { phpName: Kod, type: CHAR, size: '1', required: true }
    evfolyam: { phpName: Evfolyam, type: INTEGER, size: '11', required: true }
  tanulo:
    _attributes: { phpName: Tanulo }
    id: { phpName: Id, type: INTEGER, size: '11', primaryKey: true, autoIncrement: true, required: true }
    name: { phpName: Name, type: VARCHAR, size: '255', required: true }
    szuletes: { phpName: Szuletes, type: DATE, required: true }
    osztaly_id: { phpName: OsztalyId, type: INTEGER, size: '11', required: false, foreignTable: osztaly, foreignReference: id, onDelete: CASCADE, onUpdate: CASCADE }
    _indexes: { category_id: [osztaly_id] }

Majd futtassuk le az alábbi parancsokat is:

# hozzuk létre a formokat, filtereket, modeleket, és a táblákat is generáljuk le
# a kérdésre, miszerint kívánjuk-e hogy felülírja az adatbázisunkat válaszoljunk igennel (Y)
./symfony propel:build-all
# és a két táblánkhoz tartozó admin felületet készítsük el:
./symfony propel:generate-admin frontend osztaly
./symfony propel:generate-admin frontend tanulo

Szükségünk lesz egy pluginra, a sfJqueryReloadedPluginra. A telepítése nem túl bonyolult. Ha az összes plugint engedélyeztük (a config/ProjectConfiguration.class.php fájlban), akkor elég bemásolni a plugin könyvtárba. Mivel a letöltött tömörített fájlban mindenféle kódszámot ír a könyvtárnév végére, így a könnyebb elérhetőség miatt használjuk inkább a sfJqueryReloadedPlugin könyvtárnevet.

A lib/model/Osztaly.php fájlt pedig egészítsük ki az alábbi metódussal

public function __toString()
{
  return $this->evfolyam.'/'.$this->kod;
}

Az apps/frontend/config/routing.yml fájlt is módosítsuk, hogy az osztályok listája jelenjen meg alapértelmezetten.

homepage:
  url:   /
  param: { module: osztaly, action: index }

Ezzel az alap projektünk elkészült. Lehet listázni, új osztályt felvinni és módosítani. Azonban az osztályhoz még nem tudunk tanulót rögzíteni. Ehhez módosítsuk a lib/form/OsztalyForm.class.php fájlt.
Ez egy hosszabb lélegzetvétel lesz, mert nem aprózom el

class OsztalyForm extends BaseOsztalyForm
{
   /**
   * a form konfiguralasa
   * hozzaadjuk a tanulokat a formhoz
   * hozzadjuk a hozzaadas gombot (Uj) letrehozo widgetet is.
   */
   public function configure()
  {
    parent::setup();
    $context = sfContext::getInstance();
    $this->loadHelpers($context);

    $tanulok = $this->getObject()->getTanulos();

    //Egy ures formba eltaroljuk az embeddelt TanuloFormokat
    $this->embedForm('tanulos', new sfForm());
    $count = 0;
    foreach ($tanulok as $tanulo) {
      $this->addTanulo($count, $tanulo);
      $count ++;
    }

    // a hozzaadas gomb mint egy uj mezo kerul a formunkba
    $this->widgetSchema['addEmbedform'] = new embedderFormWidget(array(
        'url'=>url_for('osztaly/getEmbedForm'),
        'html_element' => ".sf_admin_form_field_tanulos table:first",
        ));
    $this->widgetSchema->setLabel('addEmbedform', false);
  }

  /**
   * kulonbozo helperek betoltese
   * Url helper az ajax hivashoz hasznalando helyes url megadasahoz
   * jQueryReloadedPlugin jQuery helpere
   * es a jQuery UI plugin javascript betoltese
   *
   * @param sfContext $context
   */
  public function loadHelpers($context)
  {
    $context->getConfiguration()->loadHelpers(array('jQuery','Tag','Url'));
    $context->getResponse()->addStyleSheet(sfConfig::get('sf_jquery_web_dir', '/sfJqueryReloadedPlugin') . "/css/ui-lightness/jquery-ui-1.8.2.custom.css");
    jq_add_plugins_by_name(array('ui'));
  }

  /**
   * A torles link a Tanulo mellett
   *
   * @param string $index
   * @return string
   */
  public function getEmbedFormLabel($index)
  {
    return jq_link_to_function(
      '<span class="ui-icon ui-icon-trash"></span>',
      "jQuery(this).parents('tr:first').remove(); jQuery('#osztaly_tanulos_".$index."_id').remove();",
      array('confirm' => 'Sure???'));
  }

  /**
   * A Tanulo hozzaadasa az Osztalyhoz
   *
   * Erre akkor is szuksegunk lesz, amikor egy uj tanulot veszunk fel
   *
   * @param string $num
   * @param Tanulo $tanulo
   */
  public function addTanulo($num, $tanulo = null)
  {
    if (!$tanulo)
    {
      $tanulo = new Tanulo();
    }
    $tanulo->setOsztaly($this->getObject());
    $form = new TanuloForm($tanulo);
    $form->getWidgetSchema()->offsetUnset('osztaly_id');
    $this->embeddedForms['tanulos']->embedForm($num, $form);

    // torles link
    $label = $this->getEmbedFormLabel($num);
    $this->embeddedForms['tanulos']->widgetSchema->setLabel($num,$label);

    $this->embedForm('tanulos', $this->embeddedForms['tanulos']);
  }

  /**
   *
   * Ha rogziteskor uj tanulot vettunk fel, akkor adjuk hozza az osztalyhoz
   * Ha pedig toroltunk akkor tavolitsuk el a formbol
   */
  public function bind(array $taintedValues = null, array $taintedFiles = null)
  {
    if (isset($taintedValues['tanulos']))
    {
      foreach($taintedValues['tanulos'] as $key => $tanulo)
      {
        if (!isset($this['tanulos'][$key]))
        {
          $this->addTanulo($key);
        }
      }
    }

    foreach ($this->embeddedForms['tanulos'] as $key=>$form)
    {
      if (!isset($taintedValues['tanulos'][$key]) && $key<>'_csrf_token')
      {
        $this->getWidgetSchema()->offsetGet('tanulos')->offsetUnset($key);
        $this->getValidatorSchema()->offsetGet('tanulos')->offsetUnset($key);
        unset(
          $taintedValues['tanulos'][$key],
          $taintedFiles['tanulos'][$key]);
      }
    }

    parent::bind($taintedValues, $taintedFiles);
  }

  /**
   * Tanulonak beallitjuk az osztalyat
   *
   * Amikor egy uj osztallyal egyutt viszunk fel egy tanulot, akkor
   * meg kell adnunk a tanulonak is, hogy melyik osztalyba tartozik.
   * Raadasul eltavolitottuk a tanulo from osztaly_id mezojet, így minden
   * egyeb esetben is szukseg van erre.
   *
   */
  public function saveEmbeddedForms($con = null, $forms = null)
  {
    $oszaly = $this->getObject();
    if ($forms)
    {
      foreach ($forms as $form)
      {
        if ($form instanceof sfFormObject)
        {
          $form->getObject()->setOsztaly($oszaly);
        }
      }
    }   

    return parent::saveEmbeddedForms($con, $forms);
  }

  /**
   * Ezt az osztalyfuggvenyt bovitjuk. A kikeressuk a postolt adatokbol a  tanulok
   * azonositojat (id). Amelyik tanulo azonositoja nincs benne a kapott eredmenyben,
   * toroljuk az osztalybol.
   */
  public function updateObjectEmbeddedForms ($values, $forms = null)
  {
    // $values['tanulos'][][id] elemeket, ahol id>0
    $ids = set::extract('/tanulos[id>0]/id', $values);
    if (!$forms)
    {
      $c = new Criteria();
      $c->add(TanuloPeer::OSZTALY_ID, $this->getObject()->getId());
      $c->add(TanuloPeer::ID, $ids, Criteria::NOT_IN);
      TanuloPeer::doDelete($c);
    }
    return parent::updateObjectEmbeddedForms ($values, $forms);
  }
}

Három dolgot használtunk fel a formban, amit még el kell készítenünk.

Egy widget, ami létrehozza a tanuló hozzáadása linket. Ezt embedderFormWidget néven neveztem el és a lib/widget mappába tegyük. Ez a mappa még nem létezik, létre kell hozni. Ebbe hozuk létre a embedderFormWidget.class.php fájlt:

<?php
/**
 * @author     nova
 * @version    1.0.0
 */
class embedderFormWidget extends sfWidgetForm
{
  /**
   * Configures the current widget.
   *
   * Available options:
   *
   * @param string html_element - az elem, amihez hozzafuzunk
   * @param string url - az ajay keres url-je
   *
   * @see sfWidgetForm
   */
  protected function configure($options = array(), $attributes = array())
  {
    $this->addOption('html_element');
    $this->addOption('url');
    parent::configure($options, $attributes);
  }

  /**
   * @param  string $name        The element name
   * @param  string $value       The date displayed in this widget
   * @param  array  $attributes  An array of HTML attributes to be merged with the default HTML attributes
   * @param  array  $errors      An array of errors for the field
   *
   * @return string An HTML tag string
   *
   * @see sfWidgetForm
   */
  public function render($name, $value = null, $attributes = array(), $errors = array())
  {
    $attributes = $this->getAttributes();
    $html =jq_link_to_function(
        '<span class="ui-icon ui-icon-circle-plus fright"></span><span class="fright">Új</span>',
        "jQuery.get('".$this->getOption('url')."',function(data){
            jQuery('".$this->getOption('html_element')."').append(data);
        });",
        $attributes);
    return $html;
  }
}

Aztán gondoskodnuk kell az ajax hívás válaszáról a szerver oldalon. Módosítsuk az apps/fronntedn/modules/osztaly/actions/actions.class.php fájlt az alábbi metódussal:

  /**
   * Visszaad egy új sort (widgetet) a tanulo formhoz
   *
   * @param sfWebRequest $request
   */
  public function executeGetEmbedForm(sfWebRequest $request)
  {
    $form = $this->configuration->getForm();
    $num = 'tmp_'.time();
    $form->addTanulo($num);

    return $this->renderText($form->getWidget('tanulos')->getWidget($num)->render($num));
  }

Ezen kívül még felhasználtam egy konkurens MVC rendszerben található igencsak hasznos osztályt, a
CakePHP set osztályát
Ezt persze módosítanom kellett, hogy szeresse a Symfony is. Ide tettem fel.

Letölthetővé tettem a teljes projektet is, innen.

Sajnos annyi energiám nem volt hogy lépésről lépésre építsem fel a projektet, remélem így is hasznosnak találja, aki elolvassa. Nekem meg jó jegyzet

Tovább mennék az első rész folyamányaként. Admin generátorról lesz itt is szó, néhány általános probléma megoldását tenném közzé:

• a listában szereplő mezők változtatása
• kapcsolt táblák szerinti rendezés

Eljött az idő hogy egy pici, de konkrét adatbázist kreáljunk.
Futtasuk le akár a már telepített phpmyadminban

CREATE DATABASE sandbox;
USE sandbox;
CREATE TABLE `categories` (
  `id` int(11) NOT NULL auto_increment,
  `name` varchar(255) default NULL,
  PRIMARY KEY  (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
CREATE TABLE `products` (
  `id` int(11) NOT NULL auto_increment,
  `name` varchar(255) NOT NULL,
  `price` float(9,3) default '0.000',
  `category_id` int(11) default NULL,
  PRIMARY KEY  (`id`),
  KEY `category_id` (`category_id`),
  CONSTRAINT `products_fk` FOREIGN KEY (`category_id`) REFERENCES `categories` (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

Az első leírásban létrehozott sandbox projectünket fogjuk átszerkeszteni.
Tehát állítsuk be a config könyvtárban lévő adatbázisokhoz tartozó fájlokat (propel.ini és databases.yml) az előbb létrehozott sandbox adatbázisra.
Majd futtassuk le az alábbi parancsokat is:

# generáljuk le a schema.yml fájlt
./symfony propel:build-schema
#hozzuk létre a formokat, filtereket, modeleket, -C direktiva kihagyja az sql-t (classes only)
./symfony propel:build-all -C
# és a két táblánkhoz tartozó admin felületet készítsük el:
./symfony propel:generate-admin --module=CategoriesAdmin frontend categories
# az apps/frontend/modules/CategoriesAdmin modulunkat
# és a route (apps/frontend/config/routing.yml) szabályt is létre fogja hozni
./symfony propel:generate-admin --module=ProductsAdmin frontend products

Máris érdemes létrehozni a PROJECT_DIR/apps/frontend/templates/layout.php fájlban a 2 menüpontunkat. Közvetlenül a body nyitótagja után tegyük be az alábbi sorokat.

<ul id="menu">
  <li><a href="<?php echo url_for('@categories')?>"></a>Kategóriák</a></li>
  <li><a href="<?php echo url_for('@products')?>">Termékek</a></li>
</ul>

A http://mydomain/sandbox/frontend_dev.php/CategoriesAdmin érjük el az alkalmazásunkat. Most próbáljuk meg feltölteni adatokkal. Először vigyünk fel kategóriákat. Majd próbáljunk meg, felvinni termékeket is. Elvileg el kell akadnunk amiatt, hogy a categories modelunknek még nincs __toString() metódusa. Ez egy PHP metódus, ami egy objektum kiíratására szolgál. Jelen esetünkben, mi, a name mezővel jelenítenénk meg a tábla egyes rekordjait. Így hát hozzuk létre ezt a metódust a PROJECT_DIR/lib/model/categories.php fájlban.

class Categories extends BaseCategories {
  public function __toString()
  {
    return $this->getName();
  }
} // Categories

Ezután már sikeresen megjeleníthetjük a listát, és rögzíthetünk új rekordokat. De mint láthatjuk a termékek listában nem a kategóriák neve, hanem annak azonosítója (id) szerepel, ráadásul a felhasználóknak a termékek id-ja is megjelent. Sajnos a generátorunk nem tökéletes, így a létrehozott fájlokat jó pár helyen módosítanunk kell.
Elsőként magát a PROJECT_DIR/apps/frontend/modules/ProductsAdmin/config/generator.yml fájlt módosítjuk. Figyelve a .yml fájlokra jellemző szabályokra (legfőképp, hogy behúzás nem tabulátor, hanem 2 üres hely) a listát tartalmazó sort egészítsük ki:

list:
  display: [categories, name, price ] # felsoroljuk a megjelenített mezőket, kapcsolt tábla esetén a classt
  peer_method: doSelectJoinAll # modelpeer osztályunk metódusa

Másodikként tekintsük meg a létrehozott PROJECT_DIR/apps/frontend/modules/ProductsAdmin/actions/action.class.php fájlt. Mint láthatjuk a ProductsAdminActions osztályunk az autoProductsAdminActions osztályból származik. Ez pedig a cache könyvtárban keresendő, a PROJECT_DIR/cache/frontend/dev/modules/ProductsAdmin/actions/action.class.php fájlban. Ennek az osztálynak kell 2 függvényét felül definiálnuk:

class ProductsAdminActions extends autoProductsAdminActions
{
  protected function addSortCriteria($criteria)
  {
    if (array(null, null) == ($sort = $this->getSort()))
    {
      return;
    }

    if ($sort[0] == 'categories.name')
    {
      $column = CategoriesPeer::NAME;
    }
    else
    {
      $column = ProductsPeer::translateFieldName($sort[0], BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_COLNAME);
    }

    if ('asc' == $sort[1])
    {
      $criteria->addAscendingOrderByColumn($column);
    }
    else
    {
      $criteria->addDescendingOrderByColumn($column);
    }
  }

  protected function isValidSortColumn($column)
  {
    if (in_array($column, array('categories.name')))
    {
      return true;
    }
    else
    {
      return parent::isValidSortColumn($column)
    }
  }
}

Majd hozzuk létre a PROJECT_DIR/apps/frontend/modules/ProductsAdmin/_list_th_tabular.php fájlt. Ezt is a cacheből másoltam ki és módosítottam.

<?php slot('sf_admin.current_header') ?>
<th class="sf_admin_text sf_admin_list_th_categories">
  <?php if ('categories.name' == $sort[0]): ?>
    <?php echo link_to(__('Categories', array(), 'messages'), '@products', array('query_string' => 'sort=categories.name&sort_type='.($sort[1] == 'asc' ? 'desc' : 'asc'))) ?>
    <?php echo image_tag(sfConfig::get('sf_admin_module_web_dir').'/images/'.$sort[1].'.png', array('alt' => __($sort[1], array(), 'sf_admin'), 'title' => __($sort[1], array(), 'sf_admin'))) ?>
  <?php else: ?>
    <?php echo link_to(__('Categories', array(), 'messages'), '@products', array('query_string' => 'sort=categories.name&sort_type=asc')) ?>
  <?php endif; ?>
</th>
<?php end_slot(); ?>
<?php include_slot('sf_admin.current_header') ?>

<?php slot('sf_admin.current_header') ?>
<th class="sf_admin_text sf_admin_list_th_name">
  <?php if ('name' == $sort[0]): ?>
    <?php echo link_to(__('Name', array(), 'messages'), '@products', array('query_string' => 'sort=name&sort_type='.($sort[1] == 'asc' ? 'desc' : 'asc'))) ?>
    <?php echo image_tag(sfConfig::get('sf_admin_module_web_dir').'/images/'.$sort[1].'.png', array('alt' => __($sort[1], array(), 'sf_admin'), 'title' => __($sort[1], array(), 'sf_admin'))) ?>
  <?php else: ?>
    <?php echo link_to(__('Name', array(), 'messages'), '@products', array('query_string' => 'sort=name&sort_type=asc')) ?>
  <?php endif; ?>
</th>
<?php end_slot(); ?>
<?php include_slot('sf_admin.current_header') ?><?php slot('sf_admin.current_header') ?>
<th class="sf_admin_text sf_admin_list_th_price">
  <?php if ('price' == $sort[0]): ?>
    <?php echo link_to(__('Price', array(), 'messages'), '@products', array('query_string' => 'sort=price&sort_type='.($sort[1] == 'asc' ? 'desc' : 'asc'))) ?>
    <?php echo image_tag(sfConfig::get('sf_admin_module_web_dir').'/images/'.$sort[1].'.png', array('alt' => __($sort[1], array(), 'sf_admin'), 'title' => __($sort[1], array(), 'sf_admin'))) ?>
  <?php else: ?>
    <?php echo link_to(__('Price', array(), 'messages'), '@products', array('query_string' => 'sort=price&sort_type=asc')) ?>
  <?php endif; ?>
</th>
<?php end_slot(); ?>
<?php include_slot('sf_admin.current_header') ?>

Ezzel a fájllal azonban már sikerült teljesen elontanunk a generátort. Hiszen ha új mezőket teszünk be, vagy veszünk ki, akkor ezt a fájlt újra és újra szerkesztenünk kell. Ez ellen a legjobb módszer talán az lenne, ha írnánk egy saját generátor, ami figyelembe veszi ezt. Talán később még módosítom ezt a leírást ezen ötletemmel.

Léteznek már nagyobb tudású generátorok:
ahAdminGeneratorThemesPlugin
sfAdminThemejRollerPlugin
Mindkettő Doctrinera alá készült el, de bizonyára nem túl nehéz átírni Propelesre.

Ide egy symfony 1.3 + Propel project elkészítését szánom. Ubuntu rendszeren dolgozom, azért mert egyszerűbb, mint Windowson. Ha Windowson próbálkoznék, akkor is valamilyen virtuális Linuxot (pl: virtualbox) telepítenék fejlesztői teszt környezetnek.
A symfony 1.3-ra pedig azért esett a választás, mert ez az utolsó verzió, ami kompatibilis az 1.0-val. Rengeteg 1.0-as plugin található, aminek nincs 1.2-1.3-1.4-es verziója. Ha esetleg gyorsan be kell üzemelnem valamelyiket, akkor 1.3 alatt talán könnyebb lesz. A propelt pedig azért választottam, mert a cég, ahol dolgozom ezt használja és ezért én sem használtam még doctrinet.
A projektemnél az adatbázis már kész volt és használták is. Erre fogjuk ráhúzni a symfonyt admin felületét.
Telepítsük a hiányzó szoftvereket:
Az alap rendszer az, hogy a LAMP (Linux-Apache-MySql-PHP) környezet már megvolt.
Ha mégsem, akkor egy már telepített Ubuntu/Debian Linuxon, a sudo apt-get install mysql-server phpmyadmin paranccsal a legegyszerűbb telepíteni, egy mozdulattal mindent Utána jöhet a symfony:

sudo-s #rendszergazda módba váltunk
apt-get install php-pear
pear channel-discover pear.symfony-project.com
pear install symfony/symfony-1.3.5 #ha van újabb, akkor azt
apt-get install php5-xsl #xsl php kiterjesztés telepítése, a propelhez kell
a2enmod rewrite # mod rewrite
/etc/init.d/apache restart
exit #kilépünk a rendszergazda módból
mkdir sandbox #létrehozzuk a project könyvtárat
cd sandbox #belépünk a könyvtárba
symfony generate:project sandbox --orm=Propel #project készítése
symfony generate:app frontend #alkalmazás létrehozása
# hogy a majdani felület kapja meg az alap symfony designt
ln -s /usr/share/php/data/symfony/web/sf web/sf

Ezzel létre is hoztunk egy alkalmazást.
Ami problémával szembesülhetünk hogy valamiért nem lehet újraindítani az apache szervert, mert a 80/443-as portok valamelyike már foglalt. Ez általában az /etc/apache/ports.conf fileban keletkezett duplikált bejegyzés miatt fordulhat elő. Töröljük az egyiket…

Most be kell állítanunk az adatbázist. Ez most több fájlt érint, hiszen alapból az 1.3 már doctrine modeleket használ, ha a projektet nem –orm=Propel direktívával hoztuk létre. Mi azzal tettük
De ha mégsem, akkor először is szükségünk lesz egy propel.ini fájlra a sandbox/config könyvtárunkban. A fájlt nekünk kell létrehozni az alábbi sorokkal. Értelemszerűen át kell szerkeszteni (host,dbname, password, user, output dir), akkor is ha nem mi hoztuk létre.

propel.targetPackage       = lib.model
propel.packageObjectModel  = true
propel.project             = sandbox
propel.database            = mysql
propel.database.driver     = mysql
propel.database.url        = mysql:host=localhost;dbname=teszt
propel.database.creole.url = ${propel.database.url}
propel.database.user       = felhsznalo
propel.database.password   = jelszo
propel.database.encoding   = utf8

; mysql options
propel.mysql.tableType     = InnoDB

propel.addVendorInfo       = true
propel.addGenericAccessors = true
propel.addGenericMutators  = true
propel.addTimeStamp        = true
propel.addValidators       = false

propel.useDateTimeClass       = true
propel.defaultTimeStampFormat = Y-m-d H:i:s
propel.defaultTimeFormat      = H:i:s
propel.defaultDateFormat      = Y-m-d

propel.schema.validate        = false
propel.samePhpName            = false
propel.disableIdentifierQuoting     = false
propel.emulateForeignKeyConstraints = true

; directories
propel.home                    = .
propel.output.dir              = /home/user/sandbox
propel.schema.dir              = ${propel.output.dir}/config
propel.conf.dir                = ${propel.output.dir}/config
propel.phpconf.dir             = ${propel.output.dir}/config
propel.sql.dir                 = ${propel.output.dir}/data/sql
propel.runtime.conf.file       = runtime-conf.xml
propel.php.dir                 = ${propel.output.dir}
propel.default.schema.basename = schema
propel.datadump.mapper.from    = *schema.xml
propel.datadump.mapper.to      = *data.xml

; builder settings
propel.builder.peer.class              = plugins.sfPropelPlugin.lib.builder.SfPeerBuilder
propel.builder.object.class            = plugins.sfPropelPlugin.lib.builder.SfObjectBuilder
propel.builder.objectstub.class        = plugins.sfPropelPlugin.lib.builder.SfExtensionObjectBuilder
propel.builder.peerstub.class          = plugins.sfPropelPlugin.lib.builder.SfExtensionPeerBuilder
propel.builder.objectmultiextend.class = plugins.sfPropelPlugin.lib.builder.SfMultiExtendObjectBuilder
propel.builder.mapbuilder.class        = plugins.sfPropelPlugin.lib.builder.SfMapBuilderBuilder

propel.builder.addIncludes  = false
propel.builder.addComments  = true
propel.builder.addBehaviors = true

a config/database.yml fájlt is átszerkesztjük:

dev:
  propel:
    param:
      classname:  DebugPDO
      debug:
        realmemoryusage: true
        details:
          time:       { enabled: true }
          slow:       { enabled: true, threshold: 0.1 }
          mem:        { enabled: true }
          mempeak:    { enabled: true }
          memdelta:   { enabled: true }

test:
  propel:
    param:
      classname:  DebugPDO

all:
  propel:
    class:        sfPropelDatabase
    param:
      classname:  PropelPDO
      dsn:        mysql:dbname=teszt;host=localhost
      username:   user
      password:  password
      encoding:   utf8
      persistent: true
      pooling:    true

Majd át kell szerkeszteni a config/ProjectConfiguration fájlt is. Engedélyezzük a pluginokat.

  public function setup()
  {
     $this->enableAllPluginsExcept(array('sfDoctrinePlugin'));
     // vagy : $this->enablePlugins('sfPropelPlugin');
  }

Ezekután az adatbázisunkhoz legeneraálhatjuk a schema.yml fájlt. Majd abból a modelt, a formot és a filtereket. Majd végül az első modulunkat is (modelname a modelünk – táblánk – neve):

# az alábbi paranccsal tudjuk a web könyvtárunkba a szükséges symlinkeket
# létrehozni, amire szintén a design miatt lesz szükség
./symfony plugin:publish-assets
./symfony propel:build-schema #ezzel jön létre a config/schema.yml fájl a beállított adatbázis alapján
./symfony propel:build-model #modelek (táblák) legenerálása
./symfony propel:build-form #formok generálása
./symfony propel:build-filter #a táblázatokhoz tartozó filterek legenerálása
# vagy az előző 3 helyett csak egyszerűen
# ./symfony propel:build-all --classes-only
# most pedig következzen a tábláink admin felületének legenerálása:
./symfony propel:generate-admin frontend modelname #a modul is ezt a nevet kapja
# vagy ha más néven szeretnénk:
#./symfony propel:generate-admin --module="modelnameAdmin" frontend modelname

Az utolsó parancsot érdemes az összes modulunkra (értsd: tábla) lefuttatni.
Én két problémába ütköztem, ezen parncsok futtatásakor.

• A propel nem szereti a default értékként beállított CURRENT_TIMESTAMP-et, viszont a schema.yml-be beírja. Ezért át kellett szerkesztenem a generált fájlban: defaultValue: ‘0000-00-00 00:00:00′.
  Ráadásul a hibaüzenet is nagyon buta volt:Szegmens hiba. Na ebből találja ki az ember
• A másik probléma pedig az volt, hogy szerettem volna egyben lefuttatni a model, form, filter építő parancsokat, de elfogyott a memória. Nem tudom melyik memória volt kevés, mert a php.ini-ben a négyszeresére emeltem, de még mindig ugyanannyira kevés volt. De legalább a hibaüzenet és az utasítások érthetők voltak

Zárjuk le egyszerűen a telepítésünket:
Lehetne szenvedni az apache virtuális könyvtáraival, de az egy másik leírás lesz.
Most egy egyszerű Linux link is megteszi nekünk. Tehát létre kell hozni a /var/www könyvtárban egy linket a projectünknek. Ehhez el lehetne mélyednünk az ln parancs használatában, de én mindig a midnight commandert használtam ehhez. Ha nem lenne feltelepítve, akkor a sudo apt-get install mc paranccsal telepíthetjük. A két ablakos rendszerben a CTRL+X, majd utána S gomb lenyomásával hozhatunk létre linket. Hozzuk hát létre a /var/www könyvtárban egy linket sandbox néven, ami a sandbox/web könyvtárunkra mutat. És a máris elérhető a táblázatunk a http://mydomain/sandbox/index.php/modul url alatt. Ehhez lehet rendszergazdai módba kell váltanunk.

Ha el akarjuk hagyni az index.php -t az URL-ből, akkor az /etc/apache/sites-available/default fájlt kell módosítani. A “Directory” szegmens alatt az AllowOverride None sort módosítani kell AllowOverride All -ra. Ezzel engedélyezzük a .htaccess fájlok használatát. Így a http://mydomain/sandbox/index.php/modul helyett használhatjuk simán a http://mydomain/sandbox/modul URL-t is.

Illetve ha valami hibába ütköznénk, akkor a fehér képernyő helyett a http://mydomain/sandbox/frontend_dev.php/modul alatt informálódhatunk a problémáról. Ha nem localhoston dolgozunk, akkor a frontend_dev.php fájl elején engedélyeznünk kell a saját IP címünket is.

amiket sokat kerestem, hogy többet ne kelljen

//sfGuardUser ID:
sfContext::getInstance()->getUser()->getGuardUser()->getId()

//Hogyan alakitsuk egy objetum name tulajdonságát id 'formátumura':
get_id_from_name($name)

// form formázása (<p> stílus):
// http://www.thatsquality.com/articles/7-days-of-symfony-1-1-forms-widgets-and-validators-day7
$formatter = $this->getWidgetSchema()->getFormFormatter();
$formatter->setErrorRowFormat('%errors%');
$formatter->setErrorListFormatInARow("%errors%\n");
$formatter->setErrorRowFormatInARow("<p class='error-message'>%error%</p>");
$formatter->setRowFormat("%error%<p>%label%%field%%help%%hidden_fields%</p>\n");
// ez alapból nem hívodik meg. De ha a formatter használja, pl: embeddformnál:
$formatter->setDecoratorFormat('<table class="tgTextSlot">%content%</table>');

// hogyan adjunk egy form elemnek classt:
// formban :
$this->WidgetSchema['name']->setAttribute('class', 'classname');
// templateben 1:
echo $form->render(array('name' => array('class' => 'classname'), 'name2' => array('class'=>'classname'))) ;
// templateben 2:
echo $form['name']->renderRow(array('class' => 'classname'));

//formban widget mozgatása:
$this->getWidgetSchema()->moveField('widget_name', sfWidgetFormSchema::AFTER, 'last_name');

//$this változóinak lekérdezése
$this->getVarHolder()->getAll()

//SF_ENVIRONMENT 1.2 alatt:
sfConfig::get('sf_environment')

// összes request paraméter lekérése
$this->getRequest()->getParameterHolder()->getAll();
sfContext::getInstance()->getRequest()->getParameterHolder()->getAll()

// egy bizonyos request paraméter lekérése
$this->getRequestParameter('parameter', false);
sfContext::getInstance()->getRequest()->getParameter('parameter');

// controllerben helper használata
sfLoader::loadHelpers(array('Tag', 'Url'));
sfContext::getInstance()->getConfiguration()->loadHelpers(array('Tag', 'Url'));

//i18N akárhol:
sfContext::getInstance()->getI18N()->__('Nincs kiválasztva')

i18N formban:
$this->getWidgetSchema()->getFormFormatter()->translate('szoveg');

// Ez inkább propel. A model osztályból, annak sql neve:
constant(get_class($this->getPeer()).'::TABLE_NAME')

// ajax link
echo link_to_remote('postolunk', array(
'update'    => 'a div id-ja amibe a visszatérő adatokat kapjuk',
'url'       => 'az ajaxos url',
'method'    => 'post',
//ez meghívja a validate javascript függvényt:
'condition' => "validate(Form.serialize('formId'))",
//és a legfontosabb, így lehet a form adatait is elküldeni:
'submit'    => "formId"
))

// A form mezői:
$this->getWidgetSchema()->getPositions()

// egy form hibát dob, de az épp rejtett, akkor irassuk ki.
$this->form->getErrorSchema()
foreach($this->form->getErrorSchema()->getErrors() as $key => $error)
{
  echo '<p>' . $key . ': ' . $error . '</p>';
}

// absolute url:
link_to(__('szöveg', array(), 'messages'), '@url', array('absolute'=>true))

Callback validator

class aForm extends aBaseForm
{
  public function configure()
  {
    parent::configure() ; //esetleg ez nem fontos
    $this->validatorSchema->setPostValidator(new sfValidatorCallback(array('callback' => array($this, 'fuggvenyneve'))));
  }

  public function fuggvenyneve(sfValidatorBase $validator, array $values)
  {
    // $values tartalmazza az összes adatot, feldolgozod és a $hibavan-nak ennek függvényében értéket adsz:
    if ($hibavan)
    {
      throw new sfValidatorError($validator, 'hibaüzenet');
    }

    return $values;
  }
}

Propel

$c = new Criteria();
$c->addJoin(
    array(ReaderFavoritePeer::BOOK_ID,ReaderFavoritePeer::READER_ID),
    array(BookOpinionPeer::BOOK_ID,BookOpinionPeer::READER_ID))

// és irassuk is ki a criteriát SQL-ben
echo $criteria->toString(); 

// szerezzük meg az ID-kat egy táblából.
$c = new Criteria();
$c->addSelectColumn(MyClassPeer::ID);
$res = BasePeer::doSelect($c);
$Ids = $res->fetchAll(PDO::FETCH_COLUMN,0);

// SELECT  FROM `tabla` WHERE (tabla.mezo1='string1' OR (tabla.mezo1='string2' AND tabla.mezo2='0'))
$c = new Criteria();
$cr1 = $c->getNewCriterion(TablePeer::MEZO1, 'string1');
$cr2 = $c->getNewCriterion(TablePeer::MEZO1, 'string2');
$cr3 = $c->getNewCriterion(TablePeer::MEZO2, '0');
$cr2->addAnd($cr3);
$cr1->addOr($cr2);
$c->add($cr1);
$c->toString();

Task

./symfony i18n:extract frontend hu --auto-save
./symfony i18n:extract frontend hu --display-new

Internationalization

      //http://www.php.net/manual/en/function.strftime.php
      fb(format_date(time(), 'f'),'f');
      fb(format_date(time(), 'G'),'G');
      fb(format_date(time(), 'y'),'y');
      fb(format_date(time(), 'M'),'M');
      fb(format_date(time(), 'd'),'d');
      fb(format_date(time(), 'h'),'h');
      fb(format_date(time(), 'H'),'H');
      fb(format_date(time(), 'm'),'m');
      fb(format_date(time(), 's'),'s');
      fb(format_date(time(), 'E'),'E');
      fb(format_date(time(), 'D'),'D');
      fb(format_date(time(), 'F'),'F');
      fb(format_date(time(), 'W'),'W');
      fb(format_date(time(), 'w'),'w');
      fb(format_date(time(), 'a'),'a');
      fb(format_date(time(), 'k'),'k');
      fb(format_date(time(), 'K'),'K');
      fb(format_date(time(), 'z'),'z');

A smarty egyszerű

        {assign var='createdat' value=$current_page->getCreatedAt()}
        {assign var='createdat' value=$createdat|strtotime}
        {capture assign='createdat'}
          {format_date date=$createdat format="D"}
        {/capture}
        <p class="date">{$createdat}</p>

        // Mert PHP-ban ennyi:
        <?php echo format_date(strtotime($current_page->getCreatedAt())), 'D'); ?>

Add a custom filter field for generated admin

  public function configure() {

    $this->widgetSchema['title'] = new sfWidgetFormFilterInput();

    $this->validatorSchema['title'] = new sfValidatorPass(array('required' => false));
  }//configure

  public function getFields() {
    return array_merge(array(
        'title'=> 'Title',
      ), parent::getFields()
    );
  } //getFields

  protected function addTitleColumnCriteria(Criteria $criteria, $field, $values) {

    // $values['text'] contains the field value, use it to change $criteria object

    // es. $criteria->add ('column', $values['text'])

  }//addTitleColumnCriteria

loggolás külön fájlba.

    $text = var_export($this->getObject()->toArray(), true);
    $file = sfConfig::get('sf_log_dir').DIRECTORY_SEPARATOR.'debug.log';
    $dispatcher = sfContext::getInstance()->getEventDispatcher();
    $logger = new sfFileLogger($dispatcher, array('file' => $file) );
    $dispatcher->disconnect('application.log', array($logger, 'listenToLogEvent'));
    $logger->err($text);
    $logger->notice($text);
    $logger->info($text);

Doctrine:

//kapcsolt táblák lekérdezése:
foreach (Doctrine_Core::getTable('CompanyLog')->getRelations() as $name => $relation)
{
  echo $name . ":\n"; echo "Local - " . $relation->getLocal() . "\n"; echo "Foreign - " . $relation->getForeign() . "\n\n";
}

hogyan formázzunk egy sfWidgetFormChoice widgetet?

// a widget
$this->widgetSchema ['my_widget'] = new sfWidgetFormChoice(array('multiple' => true, 'expanded' => true, 'choices' => my_choices, 'renderer_class' => 'sfWidgetFormSelectCheckbox', 'renderer_options' => array('formatter' => array('MyForm', 'MyFormatter'))));

$this->validatorSchema ['my_widget'] = new sfValidatorChoice(array('multiple' => true, 'choices' => array_keys(my_choices), 'required' => false));

// és a formban:
public static function MyFormatter($widget, $inputs) {
       $result = '<table>';
       foreach ($inputs as $input) {
          $result .= '<tr><td>' . $input ['label'] . '   ' . $input ['input'] . '</td></tr>';
        }
        $result .= '</table>';
        return $result;
}

néha szükségünk lehet egy olyan widgetre, ami egy tömböt/listát tartalmaz.
Én most egy két dimenziós tömböt fogok megjeleníteni:

    protected function getWidgetFormSchemaForMyField($choices)
    {
      $widget = new sfWidgetFormSchema(array(
         'mezo1' =>  new sfWidgetFormPlain(),
         'mezo2' =>  new sfWidgetFormInputHidden(),
         'mezo3'   =>  new sfWidgetFormChoice(array('choices'=>$choices))
      ));

      // a mezők a táblázat egyes cellái lesznek, tehát egymás mellett lesznek:
      $widget->getFormFormatter()->setRowFormat('<td>%error%%field%%help%%hidden_fields%</td>');
      return $widget;
    }

    public function configure()
    {
        ...
        // itt le kell kérni a rekordokat
        // a choices tömbnek is értéket kell adni

        $widgetrows = array();
        foreach ($records as $key=>$record)
        {
          $widgetrows[$key] = $this->getWidgetFormSchemaForMyField($choices);
        }
        $widget = new sfWidgetFormSchema($widgetrows);
        $formatter = $widget->getFormFormatter();
        // a táblázat egyes sorai (a fenti három mező egy sorban, de azokból több sor lesz):
        $formatter->setRowFormat('<tr>%error%%field%%help%%hidden_fields%</tr>');

        $this->widgetSchema['mezo'] = new sfWidgetFormSchema(array($widget));
        $formatter = $this->widgetSchema['mezo']->getFormFormatter();
        // bele kell tenni az egészet egy táblázatba:
        $formatter->setRowFormat('<table>%error%%field%%help%%hidden_fields%</table>');

        ...
    }

Egy jó postvalidator leírás:

blog.codeclarity.com/2010/03/09/conditional-validation-in-symfony-forms/

Symfony widgeteket fogok ide kirakni, néhol egy icipici kis magyarázattal.

datePicker:

class datePickerWidget extends sfWidgetFormInput
{

  public function configure($options = array(), $attributes = array())
  {
    $this->addOption('ifFormat', "%Y-%m-%d");
    parent::configure($options, $attributes);
  }

  public function render($name, $value = null, $attributes = array(), $errors = array())
  {
    use_helper('Javascript', 'wtCurrency');
    $response = sfContext::getInstance()->getResponse();
    $response->addStylesheet('/sf/calendar/calendar-system.css');
    $response->addJavascript('/sf/calendar/calendar.js');
    $response->addJavascript('/sf/calendar/lang/calendar-en.js');
    $response->addJavascript('/sf/calendar/calendar-setup.js');
    $response->addJavascript(sfConfig::get('sf_prototype_web_dir').'/js/prototype');

    $picker = javascript_tag("
      Calendar.setup(
      {
        inputField  : '".$this->generateId($name)."',
        ifFormat    : '".$this->getOption('ifFormat')."',
        button      : 'trigger',    // ID of the button
      })
    ");
    return parent::render($name, $value, $attributes, $errors) . $picker;
  }
}

Autocompliter:
innen az eredeti

class sfExtraWidgetFormInputAutocomplete extends sfWidgetFormInput
{
    public function configure($options = array(), $attributes = array())
    {
        $this->addRequiredOption('url');
        $this->addOption('param', 'autocomplete');
        $this->addOption('min_chars', 2);
        $this->addOption('afterUpdateElement','');
        parent::configure($options, $attributes);
    }

    public function render($name, $value = null, $attributes = array(), $errors = array())
    {
        $response = sfContext::getInstance()->getResponse();
        $response->addJavascript(sfConfig::get('sf_prototype_web_dir').'/js/prototype');
        $response->addJavascript(sfConfig::get('sf_prototype_web_dir').'/js/scriptaculous.js');
        sfLoader::loadHelpers(array('Javascript'));
        $response->addStylesheet('/sfExtraWidgetsPlugin/css/autocompleter.css');

        $autocompleteDiv = content_tag('div' , '', array('id' => $this->generateId($name) . '_autocomplete', 'class' => 'autocomplete'));

        $autocompleteJs = javascript_tag(
            "function ac_update_" . $this->generateId($name) . "(text, li)
            {
                $('" . $this->generateId($name) . "').value = li.innerHTML;
                ".$this->getOption('afterUpdateElement')."
            }

            new Ajax.Autocompleter(
                '" . $this->generateId($name) . "',
                '" . $this->generateId($name) . '_autocomplete' . "',
                '" . url_for($this->getOption('url')) . "',
                {
                    paramName: '" . $this->getOption('param') . "',
                    indicator: 'indicator-" . $this->generateId($name) . "',
                    minChars: " . $this->getOption('min_chars') . ",
                    afterUpdateElement: ac_update_" . $this->generateId($name) . "
                });"
            );

        return parent::render($name, $value, $attributes, $errors) .
        '<span id="indicator-' . $this->generateId($name) . '" style="display: none;">&nbsp;&nbsp;<img src="/sfExtraWidgetsPlugin/img/ajax-loader.gif" align="absmiddle" alt="Loading" /></span>' .
        $autocompleteDiv .
        $autocompleteJs;
    }
}

használata:
widget:

$this->widgetSchema['nevsearch']     = new sfExtraWidgetFormInputAutocomplete(array(
            'url'=>'modul/action',
            'afterUpdateElement'=>'afterUpdateElement_nevsearch(text, li)'));
// ezt a javascript függvényt létre kell hozni.
//vagy egyszerűen az eredti módszerrel:
$this->widgetSchema['projekt']   = new sfExtraWidgetFormInputAutocomplete(array('url'=>'modul/action'));

actionSuccess.php

<ul>
  <?php foreach ($words as $value):?>
    <li id='<?php echo $value?>'><?php echo $value?></li>
  <?php endforeach?>
</ul>

checkbox

$this->widgetSchema['checkbox'] = new sfWidgetFormInputCheckbox();
$this->validatorSchema['checkbox'] = new sfValidatorPass();

checkbox rejtett false értékkel
A’ la cakephp. A lényeg hogy vizsgálhassuk a mező értékét, mert a symfonyban alapból nem jön semmi a post adatokkal, ha a checkbox nincs kiválasztva…

class sfWidgetFormInputCheckboxExtend extends sfWidgetFormInputCheckbox
{
  public function render($name, $value = null, $attributes = array(), $errors = array())
  {
    $hidden = new sfWidgetFormInputHidden();
    $hidden = $hidden->render($name, 0, array('id'=>false));

    $value = ($value == 0) ? null : $value;
    $attributes['value'] = 1;

    return $hidden.parent::render($name, $value, $attributes, $errors);
  }
}

a eredeti hogyan:
Symfony Howto: Export tabular data to a csv file?
Ennek teljese kidolgozott változata található itt.
A mymodule/Csv az adatokat ;-vel elválasztva megjeleníti.
Action:

<?php
class mymoduleActions extends autoMyActions
{
  public function executeCsv(sfWebRequest $request)
  {
    $this->pager = $this->getPager();
    $c=$this->pager->getCriteria();
    $c->setLimit(false);
    $this->rows=$this->pager->getResults();
     // $response = $this->getResponse();
     // $response->setHttpHeader('Content-type', 'application/msexcel');
     // $response->setHttpHeader('Content-Disposition', 'attachment; filename=akarmi.csv');
  }
}

csvSuccess.php:

<?php
 use_helper('I18N');
 $rowBefore = '';
 $rowAfter  = "\r\n";
 $cellBefore = '';
 $cellAfter = ';';
 $cellHeadBefore = '';
 $cellHeadAfter =';';
 echo $rowBefore;
 echo $cellHeadBefore.iconv('UTF-8', 'WINDOWS-1250', __('Head1')).$cellHeadAfter;
 echo $cellHeadBefore.iconv('UTF-8', 'WINDOWS-1250', __('Head1')).$cellHeadAfter;
 echo $rowAfter;
 foreach($rows as $row)
 {
   echo $rowBefore;
   echo $cellBefore.iconv('UTF-8', 'WINDOWS-1250', $row->getMezo1()).$cellAfter;
   echo $cellBefore.iconv('UTF-8', 'WINDOWS-1250', $row->getMezo2()).$cellAfter;
   echo $rowAfter;
 }

Ezután már csak a következőket kell beállítani:

• vigyünk fel egy új routing szabályt a routing.yml fájlba

  export_excel:
    url:    /export.csv
    param:  {module: myModule, action: csv}
  

• Apache mod_rewrite esetén egy új szabályra van szükség az apache .htaccess fájlba a .csv fájlok elérése végett.

  RewriteCond %{REQUEST_URI} !\.csv$

• A mymodule/config/view.yml fájlba vigyük fel az aléábbi sorokat:

  csvSuccess:
    has_layout: off
    http_metas:
      content-type: application/msexcel
      Content-Disposition: attachment; filename=mymodule_<?php echo date('Ymd')?>.csv

• vagy az actionben

        $response = $this->getResponse();
        $response->setHttpHeader('Content-type', 'application/msexcel');
        $response->setHttpHeader('Content-Disposition', 'attachment; filename=mymodule-'.date('Ymd').'.csv');
        $this->setLayout(false);
  

még egy fontos dolog:
Vagyis ha a szokványos módon csak egy táblázatot teszünk ki és azt mondjuk hogy az egy Excel fájl, akkor néha szükség lehet egy cellában több sorra is, akkor a <br> az alábbi stílussal fog működni:

br {mso-data-placement:same-cell;}