Il modo migliore per includere file CSS / JS nella mia estensione personalizzata

Se devo includere file CSS o JS nelle mie estensioni personalizzate, quale sarebbe il modo migliore e più sicuro per raggiungere questo obiettivo:

1. Devo inserirli in una cartella specifica nel mio file zip di estensione?
2. Come devo dichiarare i file nel mio manifest XML?
3. Come posso includere i file nell'intestazione Joomla (solo quando necessario)?

Il modo migliore sarebbe usare la cartella multimediale. Quindi, dovrai prima creare una cartella chiamata medianella cartella del tuo modulo.

Nota: questa cartella deve essere creata prima dell'installazione, non dopo.

All'interno della cartella multimediale, creare 2 sottocartelle csse js. Questo non è necessario ma è solo più bello tenere le cose separate.

Quindi aggiungi quanto segue al tuo file XML:

<media folder="media" destination="mod_EXAMPLE">
    <folder>css</folder>
    <folder>js</folder>
</media>

Passa mod_EXAMPLEa qualunque sia il tuo modulo.

Al momento dell'installazione, la cartella multimediale verrà automaticamente spostata e si otterrà quanto segue:

JOOMLA_ROOT/media/mod_EXAMPLE/js

e

JOOMLA_ROOT/media/mod_EXAMPLE/css

So che finora mi sono riferito a un modulo, ma lo stesso vale anche per i componenti.

Per chiamare il file, puoi aggiungere il seguente codice al tuo file default.php per la tua estensione:

JHtml::_('stylesheet', JUri::root() . 'media/mod_EXAMPLE/css/style.css');  // For CSS files
JHtml::_('script', JUri::root() . 'media/mod_EXAMPLE/js/script.js');       // For JS files

Spero che sia di aiuto

1. Presumo che la tua estensione sia un componente. Il modo migliore è creare una mediadirectory accanto admine sitedirectory. Poi mettere js, csse imgfile all'interno di directory separate come questo:

   index.html
   YOUR_COMPONENT_NAME.xml
   [+] admin
   [+] site
   [-] media
      [-] js
         main.js
         index.html
      [+] css
      [+] img
   

   Si noti che qualsiasi cartella dovrebbe avere un index.htmlfile vuoto .

2. Nel tuo manifest XML (YOUR_COMPONENT_NAME.xml), puoi dichiarare il mediafile in questo modo:

   <media destination="com_YOUR_COMPONENT_NAME" folder="media">
       <filename>index.html</filename>
       <folder>css</folder>
       <folder>js</folder>
       <folder>img</folder>
   </media>
   

3. Modifica la vista predefinita (default.php) e aggiungi queste righe per includere i file in Joomla! testa:

   $document = JFactory::getDocument();
   $document->addStyleSheet(JUri::base() . 'media/com_YOUR_COMPONENT_NAME/css/main.css');
   $document->addScript(JUri::base() . 'media/com_YOUR_COMPONENT_NAME/js/main.js');
   $test_image_url = JUri::base() . 'media/com_YOUR_COMPONENT_NAME/img/test.jpg';