Chinaunix首页 | 论坛 | 博客
  • 博客访问: 55767
  • 博文数量: 21
  • 博客积分: 1765
  • 博客等级: 上尉
  • 技术积分: 205
  • 用 户 组: 普通用户
  • 注册时间: 2008-02-13 21:25
文章分类
文章存档

2011年(15)

2008年(6)

我的朋友

分类: Python/Ruby

2011-07-18 16:58:10

来源


Convert any website layout or template into a Drupal theme - easily!

Theming for Drupal is not actually as hard as you may think. Certainly there are more advanced areas of theming possible with Drupal, which may or may not be necessary depending on the needs of your site or whether there are subtle defaults which you wish to change (and which you can learn about if and when they become necessary for your site). Creating the "overall theme" for your site though is very simple.

A Drupal theme is nothing more than a standard website layout, with a few bits of PHP code added in certain places, which you can simply copy/paste into place in order to call up Drupal's "dynamic" content and features in those spots.

If you learn better visually, videos are available which cover much of the same information that will be illustrated here: .

Contributed/downloaded themes are more complex than "your" theme needs to be

You may have looked at various pre-made themes that either come with Drupal core or are , and sighed with frustration upon seeing their code. To some, the code looks very confusing.

Keep in mind that those themes have been created to address the needs of many people. The themes must be able to handle all kinds of scenarios, which means they have been designed to allow you to dynamically add various columns and other layout elements, and to support custom theming for features and modules which you might not even need. These themes usually include a large amount of PHP code that essentially says, "If this setting is true, then show this part this way, or else show that." This makes the theme very flexible, but also very complicated.

However, your theme doesn't need to work for everyone. It only needs to do the things your site requires and nothing more. All that you need are a few bits of PHP, which you can simply copy and paste into your own HTML template. These PHP snippets tell Drupal to load its dynamic content in those spots.

You might also find it useful to have a look at Drupal's "most basic" core template files (those used when a theme doesn't provide any alternative template files to override them). To view these basic templates, look in the /modules/system folder of your Drupal installation (in particular, look at page.tpl.php and node.tpl.php).

Just a few simple & basic elements make up a Drupal theme

The "main" template file in Drupal is called page.tpl.php. Make a copy of your website layout/template and call it page.tpl.php. Then, simply paste the following bits of code into your layout, in the locations noted (all the code mentioned in this lesson goes in the page.tpl.php file).

Starting your page

If you're using Drupal 5:

print $language ?>" xml:lang="print $language ?>">

If you're using Drupal 6:

print $language->language ?>" xml:lang="print $language->language ?>" dir="print $language->dir ?>">

This is the recommended way to start your page, rather than just using . The extra definitions here aid in proper validation and language handling of the resulting HTML markup.

The section of your site

  <span style="color: rgb(0, 0, 0);"><span style="color: rgb(0, 0, 187);"><?php </span><span style="color: rgb(0, 119, 0);">print </span><span style="color: rgb(0, 0, 187);">$head_title</span><span style="color: rgb(0, 119, 0);">; </span><span style="color: rgb(0, 0, 187);">?></span></span>
  print $head; ?>
  print $styles; ?>
  print $scripts; ?>
The side bars or columns of your layout

Most websites have a left and/or right column next to the "main" larger content area. These side bars usually contain various features and information (for instance a log-in form, navigation, recent comments, etc). In Drupal these features/information are called "Blocks", and you can customize where they show up on your page by going to Administer > Site building > Blocks (admin/build/block). In order for Drupal to know where to put the Blocks though, you need to add some "placeholders" to your theme (Drupal calls these placeholders "Regions"). There are more of these placeholders available (and you can create your own custom ones too) but it's important to add the side bar one(s) at first, since the admin menu appears in them. Add the below Region(s) to your side bar:

If you're using Drupal 5:

print $sidebar_left; ?>

...and/or...

print $sidebar_right; ?>

If you're using Drupal 6:

print $left; ?>

...and/or...

print $right; ?>
Menu system / navigation

Drupal's default menu for your site's content is called Primary Links. There is also a Secondary Links menu which can show related sub-pages under the Primary menu. When stripped of all images and styles, a menu in Drupal is nothing more than a nested unordered list, in plain HTML, with links for each list item. You can use CSS to style a menu in any way you want; changing how it looks, whether it is horizontal (like tabs) or vertical, etc.

To make the Primary and Secondary Links menus appear on your site, paste the following into either the top area of your theme (for instance, if your menu is going to be styled as tabs or buttons), or in the sidebar area (for instance if you plan to have your menu show vertically in the sidebar).

Simple way:

Here's the simple version to use, if you're already sure you want to use "both" Primary and Secondary Links (or feel free to delete the Secondary Links portion if you don't need it):


  print theme('links', $primary_links); ?>



  print theme('links', $secondary_links); ?>

More flexible way:

If you're not sure that you will have both Primary and Secondary Links, you could use the following code instead (it's the same, but just does a "check" to see if the menus are enabled, and only shows them if they are):

if ($primary_links): ?>
 

    print theme('links', $primary_links); ?>
 

endif; ?>

if ($secondary_links): ?>
 

    print theme('links', $secondary_links); ?>
 
endif; ?> The main "dynamic" content of the page

At this point, you've added all of the "framework" of your site's layout which surrounds every page, and is generally similar or the same throughout the entire site. Now though, it's time to include the area where actual Content will be displayed in the template (different content depending on the page being viewed, of course).

Simply locate the spot in your template where the main content is to be displayed (usually the center of the page, after the header and between any sidebars), and paste the below code in that spot (if you'd like to re-order things feel free, but otherwise you can simply paste this as-is):

print $breadcrumb; ?>
if ($mission): ?>
print $mission; ?>
endif; ?>


if ($title): ?>

print $title; ?>endif; ?>
if ($tabs): ?>
print $tabs; ?>endif; ?>
if ($show_messages): print $messages; endif; ?>
print $help; ?>

print $content; ?>
Footer: Add footer and footer message

To add a footer region and the footer message you have set in the administration backend you can use:

if ($footer_message || $footer) : ?>

endif; ?> Add a final tag at the bottom of your theme

Paste the following at the end of your page.tpl.php file. You must have this tag at the bottom, which will dynamically include any scripts that need to appear at the bottom of the page, as well as close up any loose ends and tags that might have been left open:

print $closure; ?>

For Drupal 6: Create a YourThemeName.info file

Lastly, in Drupal 6, the one final element is to create a YourThemeName.info file (where YourThemeName is the name of your theme, with no spaces). Simply make a blank file and paste the following code into it, customize it with the appropriate name/description, and save it in the same directory along with the rest of your theme's template files:

name = YourThemeName
description = Description of YourTheme
core = 6.x
engine = phptemplate
stylesheets[all][] = style.css
regions[left] = Left sidebar
regions[right] = Right sidebar
regions[content] = Content
regions[header] = Header
regions[footer] = Footer

The "regions" portion after style.css includes all of Drupal's "standard" regions, and is recommended so that you can easily remove regions you don't want to use, or add custom regions. If you want to add custom regions, you must manually include any of the default ones you wish to keep as well or the defaults will disappear from your theme (simply copy/paste them from this page or another theme). If you want to add a custom region, simply copy one of the region lines and rename it.

That's all - Paste the above bits of code into ANY site layout or template, and you have a basic, functional Drupal theme.

Learning more about Drupal theming

There are quite a few more elements you could use in your theme if you want to. Here are a number of excellent resources for learning the more detailed aspects of theming in Drupal:

  • Full listing of available to choose from for page.tpl.php.
  • Full listing of available to choose from for page.tpl.php.
  • - this is a fantastic article, including screenshots and diagrams to help you clearly understand how Drupal's theming system works.
  • - Official theming guide on Drupal.org
Framework / Base / Starter themes

There are a variety of Framework themes (also known as Base or Starter themes), the purpose of which is to serve as a "blank slate" Drupal theme which you can build your own custom theme on top of. Many of these themes are stripped of all unnecessary styling so that they are just the core of a layout, paired with all the basic tpl.php template files for Drupal without any special customizations. Many also include a variety of helpful adjustments in their template.php files to add in commonly sought fixes and tweaks, so you'll have them before you even realize you need them. Several also add "extra" functionality that does not come by default in Drupal.

You can use these themes as a clean and simple basis for your own custom theme, or if you prefer, study them (and copy/paste from them) to see how to get Drupal's functionality into your own completely custom theme from scratch. Since these themes are clean and very lightly styled, it will be easier to work with versus other themes that are already highly customized.

Here is a list of many framework themes (though there may be more):

Additional note:

When converting an existing webpage that uses HTML references to conventional images, the references must be changed to avoid Drupal's tendancy to append "node/" to the front of relative paths.

Without any change, the new theme would change a reference into a reference.

Copy all of your original template's images into an images folder within the new theme's folder, and add the code print $base_path ?> to the front of the path to eliminate the "node/" appendage.

So an original HTML reference in the page being converted would now become print base_path() . path_to_theme(); ?>/images/myimage.jpg"/> where /images/ is a folder that you have created in the new theme for your new theme's images.

Thanks to idWorld for this solution



阅读(1589) | 评论(0) | 转发(0) |

给主人留下些什么吧!~~