Cách tốt nhất để bao gồm các tệp CSS / JS trong tiện ích mở rộng tùy chỉnh của tôi

Nếu tôi cần bao gồm các tệp CSS hoặc JS trong các tiện ích mở rộng tùy chỉnh của mình, cách tốt nhất và an toàn nhất để đạt được điều này là gì:

1. Tôi có nên đặt thư mục ia cụ thể trong tệp zip mở rộng của mình không?
2. Tôi nên khai báo các tệp trong tệp kê khai XML của mình như thế nào?
3. Làm cách nào để bao gồm các tệp trong tiêu đề Joomla (chỉ khi cần)?

Cách tốt nhất là sử dụng thư mục media. Vì vậy, trước tiên bạn sẽ cần tạo một thư mục được gọi mediatrong thư mục mô-đun của bạn.

Lưu ý: Thư mục này nên được tạo trước khi cài đặt, không phải sau.

Bên trong thư mục phương tiện, tạo 2 thư mục con cssvà js. Điều này không bắt buộc nhưng nó chỉ đẹp hơn để giữ mọi thứ riêng biệt.

Sau đó thêm phần sau vào tệp XML của bạn:

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

Thay đổi mod_EXAMPLEbất kể mô-đun của bạn là gì.

Sau khi cài đặt, thư mục phương tiện sẽ tự động được di chuyển và bạn sẽ kết thúc với các mục sau:

JOOMLA_ROOT/media/mod_EXAMPLE/js

và

JOOMLA_ROOT/media/mod_EXAMPLE/css

Tôi biết cho đến nay tôi đã đề cập đến một mô-đun nhưng áp dụng tương tự cho các thành phần quá.

Để gọi tệp, bạn có thể thêm mã sau vào tệp default.php cho tiện ích mở rộng của mình:

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

Hi vọng điêu nay co ich

1. Tôi giả sử rằng phần mở rộng của bạn là một thành phần. Cách tốt nhất là tạo một mediathư mục bên cạnh adminvà sitethư mục. Sau đó, đặt js, cssvà imgtập tin bên trong thư mục riêng biệt như thế này:

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

   Lưu ý rằng bất kỳ thư mục nên có một index.htmltập tin trống .

2. Trong bảng kê khai XML của bạn (YOU_COMPONENT_NAME.xml), bạn có thể khai báo mediatệp như thế này:

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

3. Chỉnh sửa chế độ xem mặc định (default.php) và thêm các dòng này để đưa các tệp vào Joomla! cái đầu:

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