Cara terbaik untuk memasukkan file CSS / JS dalam ekstensi kustom saya

Jika saya perlu menyertakan file CSS atau JS dalam ekstensi kustom saya, apa yang akan menjadi cara terbaik dan teraman untuk mencapai ini:

1. Haruskah saya menempatkan mereka folder khusus di file zip ekstensi saya?
2. Bagaimana saya harus mendeklarasikan file dalam manifes XML saya?
3. Bagaimana cara saya memasukkan file dalam header Joomla (hanya bila diperlukan)?

Cara terbaik adalah menggunakan folder media. Jadi, pertama-tama Anda perlu membuat folder yang disebut mediadi folder modul Anda.

Catatan: Folder ini harus dibuat sebelum menginstal, bukan setelah.

Bagian dalam folder media, buat 2 sub folder, cssdan js. Ini tidak diperlukan tetapi itu hanya lebih baik untuk memisahkan hal-hal.

Kemudian tambahkan berikut ini ke file XML Anda:

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

Ubah mod_EXAMPLEapa pun modul Anda.

Setelah instalasi, folder media akan secara otomatis dipindahkan dan Anda akan berakhir dengan yang berikut:

JOOMLA_ROOT/media/mod_EXAMPLE/js

dan

JOOMLA_ROOT/media/mod_EXAMPLE/css

Saya tahu sejauh ini saya telah merujuk ke sebuah modul tetapi hal yang sama berlaku untuk komponen juga.

Untuk memanggil file, Anda dapat menambahkan kode berikut ke file default.php Anda untuk ekstensi Anda:

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

Semoga ini membantu

1. Saya berasumsi bahwa ekstensi Anda adalah komponen. Cara terbaik adalah membuat mediadirektori di samping admindan sitedirektori. Kemudian masukkan js, cssdan imgfile di dalam direktori terpisah seperti ini:

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

   Perhatikan bahwa folder apa pun harus memiliki index.htmlfile kosong .

2. Di manifes XML Anda (YOUR_COMPONENT_NAME.xml), Anda dapat mendeklarasikan mediafile seperti ini:

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

3. Edit tampilan default (default.php) dan tambahkan baris ini untuk memasukkan file dalam Joomla! kepala:

   $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';