block.tpl.php

block.tpl.php là một tập tin khuôn mẫu tùy chọn. Nếu tập tin này được đặt dưới thư mục của một giao diện, nó sẽ quá tải lên cách ra nội dung của các khối nội dung trong hệ thống. Nếu chưa biết cách viết tập tin này như thế nào, bạn có thể tải sao chép tập tin block.tpl.php, trong thư mục themes/engines/phptemplate, vào thư mục giao diện của bạn và bắt đầu tùy chỉnh để có kết quả theo ý muốn.

Các biến hợp lệ

Sau đây là các biến hợp lệ có thể được sử dụng trong tập tin khuôn mẫu này.

Đối tượng $block bao gồm các thuộc tính

$block->module

Tên của module tạo ra khối nội dung.

$block->delta

Con số xác thực mỗi khối nội dung được tạo ra bởi một module nào đó.

$block->subject

Tiêu đề của một khối nội dung.

$block->content

Nội dung html của khối nội dung.

$block->status

Tình trạng của khối nội dung (0 or 1).

$block->region

Tên của vùng miền, theo mặc định, các vùng miền hợp lệ là 'left', 'right', 'header' và 'footer'.

$block->throttle

Thiết lập Throttle.

Các biến khác

$directory

The directory the theme is located in, e.g. themes/garland or themes/garland/minelli.

$is_front

True if the front page is currently being displayed.

$id

The sequential id of the block displayed, ie: The first block is 1, the second block is 2 etc.

$block_id

The same as $id, but is reset for the left and right sidebars.

$zebra

Alternates between 'odd' and 'even'. This is useful for creating 'zebra stripes' with your css.

$block_zebra

The same as $zebra, but is reset for the left and right sidebars.

Khuôn mẫu mặc định

block.tpl.php mặc định, có thể được tìm thấy trong themes/engines/phptemplate/block.tpl.php

Kinh nghiệm

Khi xây dựng block.tpl.php, bạn nên tận dụng các biến được cung cấp sẵn (block module, block delta, block region, ...) tạo ra các DOM ID, class, từ đó, bạn có thể truy xuất các khối nội dung các dễ dàng và uyển chuyển.

Bài dịch từ: http://drupal.org/node/11813