Pro Drupal Development

Contents at a Glance

Contents

Foreword

About the Author

About the Technical Reviewer

Acknowledgments

Introduction

How Drupal Works

What Is Drupal?

Technology Stack

Core

Administrative Interface

Modules

Hooks

Themes

Nodes

Blocks

File Layout

Serving a Request

Summary

Writing a Module

Creating the Files

Implementing a Hook

Adding Module- Specific Settings

Adding the Data Entry Form

Defining Your Own Administration Section

Presenting a Settings Form to the User

Validating User- Submitted Settings

Storing Settings

Further Steps

Summary

Hooks, Actions, and Triggers

Understanding Events and Triggers

Understanding Actions

Using the Context in Actions

Examining the Context

How Actions Are Stored

Calling an Action Directly with actions_ do()

Defining Your Own Triggers with hook_ hook_ info()

Adding Triggers to Existing Hooks

Summary

The Menu System

Callback Mapping

Menu Nesting

Access Control

Title Localization and Customization

Wildcards in Menu Items

Altering Menu Items from Other Modules

Altering Menu Links from Other Modules

Kinds of Menu Items

Common Tasks

Using menu. module

Common Mistakes

Summary

Working with Databases

Defining Database Parameters

Understanding the Database Abstraction Layer

Connecting to the Database

Performing Simple Queries

Retrieving Query Results

The Schema API

Inserts and Updates with drupal_ write_ record()

Exposing Queries to Other Modules with hook_ db_ rewrite_ sql()

Connecting to Multiple Databases Within Drupal

Using a Temporary Table

Writing Your Own Database Driver

Summary

Working with Users

The $ user Object

Introduction to hook_ user()

The User Registration Process

The Login Process

External Login

Summary

Working with Nodes

So What Exactly Is a Node?

Not Everything Is a Node

Creating a Node Module

How Nodes Are Stored

Creating a Node Type with CCK

Restricting Access to Nodes

Summary

The Theme System

Theme System Components

Installing a Theme

Building a PHPTemplate Theme

Understanding Template Files

Advanced Drupal Theming

Summary

Working with Blocks

What Is a Block?

Block Configuration Options

Block Placement

Defining a Block

Building a Block

Enabling a Block When a Module Is Installed

Block Visibility Examples

Summary

The Form API

Understanding Form Processing

Creating Basic Forms

Form API Properties

Summary

Manipulating User Input: The Filter System

Filters

Filters and Input Formats

Creating a Custom Filter

Protecting Against Malicious Data

Summary

Searching and Indexing Content

Building a Custom Search Page

Using the Search HTML Indexer

Summary

Working with Files

How Drupal Serves Files

PHP Settings

Media Handling

File API

Summary

Working with Taxonomy

What Is Taxonomy?

Kinds of Taxonomy

Viewing Content by Term

Storing Taxonomies

Module- Based Vocabularies

Common Tasks

Taxonomy Functions

Additional Resources

Summary

Caching

Knowing When to Cache

How Caching Works

How Caching Is Used Within Drupal Core

Summary

Sessions

What Are Sessions?

Usage

Session- Related Settings

Storage

Session Life Cycle

Session Conversations

Common Tasks

Summary

Using jQuery

What Is jQuery?

The Old Way

How jQuery Works

jQuery Within Drupal

Building a jQuery Voting Widget

Next Steps

Summary

Localization and Translation

Enabling the Locale Module

User Interface Translation

Starting a New Translation

Installing a Language Translation

Right- to- Left Language Support

Language Negotiation

Content Translation

Localization- and Translation- Related Files

Additional Resources

Summary

XML-RPC

What Is XML- RPC?

Prerequisites for XML- RPC

XML- RPC Clients

A Simple XML- RPC Server

Built- In XML- RPC Methods

Summary

Writing Secure Code

Handling User Input

Handling URLs Securely

Making Queries Secure with db_ query()

Keeping Private Data Private with db_ rewrite_ sql()

Dynamic Queries

Permissions and Page Callbacks

Cross- Site Request Forgeries ( CSRF)

File Security

Encoding Mail Headers

Protecting cron. php

SSL Support

Stand- Alone PHP

AJAX Security

Form API Security

Protecting the Superuser Account

Using eval()

Summary

Development Best Practices

Coding Standards

PHP Comments

Checking Your Coding Style Programmatically

Finding Your Way Around Code with egrep

Taking Advantage of Version Control

Creating and Applying Patches

Maintaining a Module

Mixing SVN with CVS for Project Management

Testing and Developing Code

The Module Builder Module

Application Profiling and Debugging

Summary

Optimizing Drupal

Finding the Bottleneck

Drupal- Specific Optimizations

Architectures

Summary

Installation Profiles

Where Profiles Are Stored

How Installation Profiles Work

Summary

Database Table Reference

access ( user module)

accesslog ( statistics module)

actions ( trigger module)

actions_ aid ( trigger module)

aggregator_ category ( aggregator module)

aggregator_ category_ feed ( aggregator module)

aggregator_ category_ item ( aggregator module)

aggregator_ feed ( aggregator module)

aggregator_ item ( aggregator module)

authmap ( user module)

batch ( batch. inc)

blocks ( block module)

blocks_ roles ( block module)

book ( book module)

boxes ( block module)

cache

cache_ block ( block module)

cache_ filter ( filter module)

cache_ form

cache_ menu

cache_ page

cache_ update

comments ( comment module)

contact ( contact module)

files ( upload module)

filter_ formats ( filter module)

filters ( filter module)

flood ( contact module)

forum ( forum module)

history ( node module)

languages ( locale module)

locales_ source ( locale module)

locales_ target ( locale module)

menu_ custom ( menu module)

menu_ links ( menu module)

menu_ router

node ( node module)

node_ access ( node module)

node_ comment_ statistics ( comment module)

node_ counter ( statistics module)

node_ revisions ( node module)

node_ type ( node module)

openid_ association ( openid module)

permission ( user module)

poll ( poll module)

poll_ choices ( poll module)

poll_ votes ( poll module)

profile_ fields ( profile module)

profile_ values ( profile module)

role ( user module)

search_ dataset ( search module)

search_ index ( search module)

search_ node_ links ( search module)

search_ total ( search module)

sessions

system

term_ data ( taxonomy module)

term_ hierarchy ( taxonomy module)

term_ node ( taxonomy module)

term_ relation ( taxonomy module)

term_ synonym ( taxonomy module)

trigger_ assignments ( trigger module)

upload ( upload module)

url_ alias ( path module)

users ( user module)

users_ roles ( users)

variable

vocabulary ( taxonomy module)

vocabulary_ node_ types ( taxonomy module)

watchdog ( dblog module)

Resources

Code

Handbooks

Forums

Mailing Lists

User Groups and Interest Groups

Internet Relay Chat

Videocasts

Weblogs

Conferences

Contribute

Index