hook_help(), hook_node_info(), hook_form(), hook_filter(), hook_filter_tips(),
hook_action_info(), hook_theme(), hook_mail(), hook_install()

Biggest concept herein: module_invoke_all()

Step 1: sitenews.info

; $Id$
name = “sitenews”
description = “Sends an email news message to all members”
core = 6.x
php = 5.1
; dependencies = “trigger”

Step 2: sitenews.module

<?php

// $Id$
/**
* sitenews Module
* Adds a content type
* Provides an action for admininstrators
* Sends emails to all members
* Defines a new hook and a new filter as well
* @file
*/
/**
* Implementation of hook_help()
*/
function sitenews_help($path, $arg){
if($path == ‘admin/help#sitenews’){
$txt = ‘Keep members current via email.’
. ‘You will need a trigger to the corresponding action.’
. ‘Recommendation: the node publish event should be tied to the action.’;
$replace = array();
return ‘<p>’ . t($txt, $replace) . ‘</p>’;
}
}
/**
* Create the sitenewsbrief’ content type
* Implements hook_node_info()
*/
function sitenews_node_info(){
return array(
‘newsbrief’ => array(
‘module’ => ‘sitenews’,
‘name’ => t(‘News Brief’),
‘description’ => t(“A newsletter to all members”),
‘has_title’ => TRUE,
‘title_label’ => t(‘Title’),
‘has_body’ => TRUE,
‘body_label’ => t(‘News Brief’),
)
);
}
/**
* Create the form for editing sitenewsbrief nodes
* Implements hook_form()
*/
function sitenews_form(&$node){
$type = node_get_types(‘type’, $node);
if($type->has_title){
$form['title'] = array(
‘#type’ => ‘textfield’,
‘#title’ => check_plain($type->title_label),
‘#required’ => true,
‘#default_value’ => $node->title,
‘#weight’ => -5,
);
}
if($type->has_body){
$form['body_field'] = node_body_field(
$node,
$type->body_label,
$type->min_word_count
);
}
return $form;
}
/**
* Implements hook_filter()
*/
function sitenews_filter($op, $delta = 0, $format = -1, $text = ”){
global $user;

if($op == ‘list’){
$list = array(
0 => t(‘Newsletter Brief Placeholders’),
1 => t(‘Remove ALL HTML/XML Tags’),
);
return $list;
}

switch($delta){
// Delta 0 is for replacing placeholders
case 0:
switch ($op)
{
case ‘description’:
return t(‘Replaces {{salutation}} with newsletter brief ‘
. ‘salutation, and {{brief name}} with the newsletter brief ‘
. ‘name.’);
case ‘prepare’:
return $text;
case ‘process’:
$text = str_replace(
‘{{salutation}}‘,
variable_get(‘sitenews_salutation’, ‘Dear Community Member’),
$text
);
$text = str_replace(
‘{{brief name}}‘,
variable_get(‘sitenews_name’, ‘Site News’),
$text
);
return $text;
case ‘settings’:
$form['sitenews_filter'] = array(
‘#type’ => ‘fieldset’,
‘#title’ => t(‘Site Newsletter Filters’),
‘#collapsible’ => true,
‘#collapsed’ => false,
);
$form['sitenews_filter']['sitenews_salutation'] = array(
‘#type’ => ‘textfield’,
‘#description’ => t(‘The greeting’),
‘#title’ => t(‘Salutation’),
‘#default_value’ => variable_get(‘sitenews_salutation’, ‘Dear Community Member,’),
);
$form['sitenews_filter']['sitenews_name'] = array(
‘#type’ => ‘textfield’,
‘#description’ => t(‘Title of the site newsletter’),
‘#title’ => t(‘Site Newsletter Name’),
‘#default_value’ => variable_get(‘sitenews_name’, ‘Site Newsletter’),
);
return $form;
}
case 1:
switch($op)
{
case ‘description’:
return t(‘Removes all tags (HTML or XML elements).’);
case ‘prepare’:
return $text;
case ‘process’:
return strip_tags($text);
} // end switch for $op
} // end outer switch
}
/**
* Formatting instruction tips for content creators
* Implements hook_format_info()
*/
function sitenews_filter_tips($delta, $format, $long){
switch($delta){
case 0:
$text = “Instances of {{brief name}} will be ”
. “replaced by the global name for site newsletter.”
. ” {{salutation}} will be replaced with the global ”
. “greeting message.”;
if($long){
$text .= “Site Newsletter name and salutation text ”
. “can be configured from the administration interface.”;
}
return $text;
case 1:
$text = “HTML and XML tags will be removed from the final output”;
return $text;
}
}
/**
* Get a format ID by name
* This returns an Input Format ID that can be passed to check_marckup() to filter content
* If a matching format isn’t found, the default format is returned
* @param $name
* String name of the format
* @return
* The ID (an integer) of the format
*/
function sitenews_get_format($name){
$res = db_query(
“SELECT format FROM {filter_formats} WHERE name = ‘%s’“,
$name
);
$format = db_fetch_object($res);
if($format){
return $format->format;
} else {
return FILTER_FORMAT_DEFAULT;
}
}
/**
* Implements hook_action_info()
*/
function sitenews_action_info(){
watchdog(‘action‘,”Called sitenews_action_info”);
$actions['sitenews_send_action'] = array(
‘type’ => ‘node’,
‘description’ => t(‘Send site news as email to all users.’),
‘configurable’ => FALSE,
‘hooks’ => array(
‘nodeapi’ => array(‘insert’,'update’,'presave’),
)
);
return $actions;
}
/**
* Action: Send an email message to all users
*/
function sitenews_send_action(&$object, $context){
// If not a published sitenews, skip
if(!$object->status || $object->type != ‘newsbrief’){
return;
}
// Get addresses
$q = “SELECT mail, status FROM {users} ”
. “WHERE status != 0 AND uid > 0“;
$results = db_query($q);
$addresses = array();
while($obj = db_fetch_object($results)){
$addresses[] = $obj->mail;
}
if(count($addresses) == 0){
watchdog(
‘sitenews’,
‘No user email addresses were found’,
array(),
WATCHDOG_ERROR
);
return;
}
// Execute hook_sitenews()
$content = module_invoke_all(‘sitenews’);
// Build params
$params = array(
‘node’ => $object,
‘to’ => implode(‘, ‘, $addresses),
‘subject’ => $object->title,
‘context’ => $context,
‘additional content’ => $content,
);
$message = _sitenews_do_message($object, $params);
watchdog(
‘actions‘,
‘Site News “Send action fired. Sending to !mail’,
array(‘!mail’ => $params['to'])
);
}
/**
* Internal function to prepare a message and pass it on to the mailer
* @param $node
* The news brief node
* @param $params
* An array of params
*/
function _sitenews_do_message(&$node, $params){
$node = $params['node'];
$content = $params['additional content'];
// Theme the main node:
$params['body'] = theme(‘sitenews_newsbrief’, $node);
// See common.inc (element_sort() and drupal_render()
uasort($content, ‘element_sort’);
// Render each block of content;
foreach($content as $item){
$params['body'] .= theme(‘sitenews_msgblock’, $item);
}
// Send the mail:
drupal_mail(
‘sitenews’,
‘sendsitenews’,
$params['to'],
language_default(),
$params,
variable_get(‘site_mail’,NULL),
TRUE
);
}
/**
* Implements hook_theme()
*/
function sitenews_theme(){
return array(
‘sitenews_msgblock’ => array(
‘arguments’ => array(‘block’ => NULL),
),
‘sitenews_newsbrief’ => array(
‘arguments’ => array(‘node’ => NULL),
),
);
}
/**
* Theme to display a news brief in a sitenews message block
* @param $node
* The news brief node object
*/
function theme_sitenews_newsbrief($node){
$format = sitenews_get_format(‘Tagless text’);
$text = strtoupper(check_markup($node->title, $format)) . “\n\n”;
$text .= check_markup($node->body, $format) . “\n\n”;
return $text;
}
/**
* Theme for email messages
* @param $block
* A block with #title and #body set
*/
function theme_sitenews_msgblock($block){
$msg = array();
if(!empty($block['#title'])){
$title = strtoupper($block['#title']);
for ($i = 0; $i < strlen($title); ++$i){
$underline .= ‘=’;
}
$msg[] = $title;
$msg[] = $underline;
}
$msg[] = $block['#body'] .”\n”; // <– extra newline
return implode(“\n”, $msg);
}
/**
* Implementation of hook_mail()
*/
function sitenews_mail($key, &$message, $params){
switch($key){
case ‘sendsitenews’:
$message['to'] = $params['to'];
$message['subject'] = $params['subject'];
$message['body'] = $params['body'];
}
}

Step 3: sitenews.install

<?php

// $Id$
/**
* Install the newsletter module
* @file
*/
/**
* Implements hook_intall()
*/
function sitenews_install(){
$name = ‘Tagless text’;
// Check to see if the format already exists
$res = db_query(
“SELECT name FROM {filter_formats} WHERE name = ‘%s’“,
$name
);
$has_format = db_result($res);
// Create format
if (!$has_format){
db_query(
“INSERT INTO {filter_formats} (name) VALUES (‘%s’)“,
$name
);
}
$res = db_query(
“SELECT format FROM {filter_formats} WHERE name = ‘%s’“,
$name
);
$format = db_fetch_object($res);
$q = “INSERT INTO {filters} (format, module, delta, weight) ”
. “VALUES(%d, ‘newsletter’, %d, %d)“;
// First, insert the “Newsletter Brief Placeholders” filter:
db_query($q, $format->format, 0, 10);
// Second, insert the “Remove ALL HTML/XML Tags” filter:
db_query($q, $format->format, 1, 0);
}

Step 4: add to module_sitenews() to any modules that will be contributing content to these automatically generated email newsletters, example from personality module (Drupal Notes 6) follows:

function personality_theme(){
return array(
‘personality_info’ => array(
‘template’ => ‘personality_info’,
‘arguments’ => array(
‘dates’ => NULL,
‘life’ => NULL,
‘works’ => NULL,
),
),
// NEW
‘personality_sitenews’ => array(
‘arguments’ => array(‘node’ => NULL),
),
);
}
/**
* Theme function for sitenews
*/
function theme_personality_sitenews($node){
$options = array(‘absolute’ => TRUE);
$url = url(‘node/’. $node->nid, $options);
$title = strip_tags($node->title);
$body = strip_tags($node->teaser); // <– Summary
$text = implode(“\n”, array($title, $body, $url));
$text .= “\n”;
return $text;
}

/*
* Implements hook_sitenews() in sitenews module
*/
function personality_sitenews(){
$q = “SELECT nid, created FROM {node} ”
. “WHERE status = 1 AND type = ‘personality’ ”
. “ORDER BY created DESC“;
$results = db_query_range($q, 0, 3);
$new_bios = array();
while ($row = db_fetch_object($results)){
$node = node_load($row->nid);
$new_bios[] = theme(‘personality_sitenews’, $node);
}
$content['personality'] = array(
‘#weight’ => 0,
‘#title’ => t(‘Recent Biographies’),
‘#body’ => implode(“\n”, $new_bios),
);
return $content;
}

hook_form(), hook_install(), hook_uninstall(), hook_schema(), hook_node_info(), hook_perm(), hook_access(), hook_insert(), hook_update(), hook_delete(), hook_nodeapi(), hook_load(), hook_view(), hook_theme()

Step 1: sites/all/modules/personality folder

Step 2: personality.info

; $Id$
name = “Personality Content (Node) Type”
description = “This provides a custom content type to store simple online personalities”
core = 6.x
php = 5.1

Step 3: personality.install

<?php

// $Id$
/**
* Install the personality module, including its content (node) type.
* @file
*/
/**
* Implementation of hook_install()
*/
function personality_install(){
drupal_install_schema(‘personality’);
}
/**
* Implementation of hook_uninstall()
*/
function personality_uninstall(){
drupal_uninstall_schema(‘personality’);
}
/**
* Implementation of hook_schema()
*/
function personality_schema(){
$schema['personality'] = array(
‘fields’ => array(
‘vid’ => array(
‘type’ => ‘int’,
‘unsigned’ => TRUE,
‘not null’ => TRUE,
‘default’ => 0,
),
‘nid’ => array(
‘type’ => ‘int’,
‘unsigned’ => TRUE,
‘not null’ => TRUE,
‘default’ =>0,
),
‘dates’ => array(
‘type’ => ‘varchar’,
‘length’ => 127,
‘not null’ => TRUE,
‘default’ => ”,
),
// Note: On MySQL, text fields cannot have default values
‘life’ => array(
‘type’ => ‘text’,
‘not null’ => FALSE
),
‘works’ => array(
‘type’ => ‘text’,
‘not null’ => FALSE
),
),
‘indexes’ => array(
‘nid’ => array(‘nid’),
),
// Version is primary key.  Could do nid, vid.
‘primary key’ => array(‘vid’),
);
return $schema;
}

Step 4: personality.module

<?php

// $Id$
/**
* Provides the Personality content type
* @file
*/
/**
* Implementation of hook_help()
*/
function personality_help($path, $arg){
if($path == ‘admin/help#personality’){
$txt = ‘A personality is a description of a person\’s person.  Should include a brief summary, biography, date of birth, optionally date of death, and accomplishments.’;
$replace = array();
return ‘<p>’ . t($text, $replace) . ‘</p>’;
}
}
/**
* Imnplementation of hook_node_info()
*/
function personality_node_info(){
return array(
‘personality’ => array(
‘name’ => t(‘Personality’),
‘module’ => ‘personality’,
‘description’ => t(‘A personality of a person.’),
‘has_title’ => TRUE,
‘title_label’ => t(‘Personality of’),
‘has_body’ => TRUE,
‘body_label’ => t(‘Overview’),
)
);
}
/**
* Implementation of hook_form()
*/
function personality_form(&$node){
$type = node_get_types(‘type’, $node);
//Existing files: title (Personality of) and body (Overview)
if($type->has_title){
$form['title'] = array(
‘#type’ => ‘textfield’,
‘#title’ => check_plain($type->title_label),
‘#required’ => TRUE,
‘#default_value’ => $node->title,
‘#weight’ => -5,
);
}
if($type->has_body){
$form['body_field'] = node_body_field(
$node,
$type->body_label,
$type->min_word_count
);
}
// Our custom fields: Dates, Life, Works
$form['dates'] = array(
‘#type’ => ‘textfield’,
‘#size’ => 50,
‘#maxlength’ => 127,
‘#title’ => t(‘Dates’),
‘#description’ => t(‘Birth and death dates.’),
‘#default_value’ => isset($node->dates) ? $node->dates : ”,
);
$form['life'] = array(
‘#type’ => ‘textarea’,
‘#title’ => t(‘Life’),
‘#cols’ => 50,
‘#rows’ => 15,
‘#description’ => t(‘A description of this perons\’s life.’),
‘#default_value’ => isset($node->life) ? $node-life : ”,
);
$form['works'] = array(
‘#type’ => ‘textarea’,
‘#title’ => t(‘Works’),
‘#cols’ => 50,
‘#rows’ => 5,
‘#description’ => t(‘This person\’s Personality’),
‘#default_value’ => isset($node->works) ? $node->works : ”,
);
return $form;
}
/**
* Implements hook_perm()
* Responsible for registering new permissions
*/
function personality_perm(){
return array(
‘create personality node’,
‘edit personality nodes’,
‘delete personality nodes’,
);
}
/**
* Implementation of hook_access()
* which implements our new permissions
*/
function personality_access($op, $node, $account){
switch($op){
case ‘create’:
return user_access(‘create personality node’, $account);
case ‘update’:
return user_access(‘edit personality nodes’, $account);
case ‘delete’:
return user_access(‘delete personality nodes’, $account);
}
}
/**
* Implements hook_insert()
*/
function personality_insert($node){
if(!isset($node->life)){
$node->life = ”;
}
if(!isset($node->works)){
$node->works = ”;
}
db_query(
“INSERT INTO {personality} (vid, nid, dates, life, works) VALUES (%d, %d, ‘%s’, ‘%s’, ‘%s’)“,
$node->vid,
$node->nid,
$node->dates,
$node->life,
$node->works
);
}
/**
* Implements hook_update()
*/
function personality_update($node){
if($node->revision){
personality_insert($node);
}
else{
db_query(
“UPDATE {personality} SET dates = ‘&s’, life = ‘%s’, works = ‘%s’ WHERE vid = %d“,
$node->dates,
$node->life,
$node->works,
$node->vid
);
}
}
/**
* Implements hook_delete()
*/
function personality_delete($node){
db_query(
“DELETE FROM {personality} WHERE nid = %d“,
$node->nid
);
}
/**
* This implementation deletes node revisions
* Implements hook_nodeapi()
*/
function personality_nodeapi(&$node, $op, $teaser, $page){
if($op == ‘delete revision’){
db_query(
‘DELETE FROM {personality} WHERE vid = %d‘,
$node->vid
);
}
}
/**
* Implementation of hook_load()
*/
function personality_load($node){
$result = db_query(
‘SELECT dates, life, works FROM {personality} WHERE vid = %d‘,
$node->vid
);
return db_fetch_object($result);
}
/**
* Implementation of hook_view()
*/
function personality_view($node, $teaser = FALSE, $page = FALSE){
$node = node_prepare($node, $teaser);
$dates = check_plain($node->dates);
$life = check_markup($node->life);
$works = check_markup($node->works);
// Add theme
$node->content['personality_info'] = array(
‘#value’ => theme(‘personality_info’, $dates, $life, $works),
‘#weight’ => 1,
);
return $node;
}
/**
* Implements hook_theme()
*/
function personality_theme(){
return array(
‘personality_info’ => array(
‘template’ => ‘personality_info’,
‘arguments’ => array(
‘dates’ => NULL,
‘life’ => NULL,
‘works’ => NULL,
),
),
);
}

Step 5: personality_info.tpl.php template theme file

<?php

// $Id$
/**
* Template to display personality nodes.
*
* Fields available:
* $dates: cleaned plain text string
* $life: cleaned HTML string
* $works: cleaned HTML string
*/
?>
<div>
<h2><?php print t(‘Dates’); ?>:</h2>
<?php print $dates; ?>
<h2><?php print t(‘Life’); ?>:</h2>
<?php print $life; ?>
<h2><?php print t(‘Works’); ?>:</h2>
<?php print $works; ?>
</div>

Step 1, of course, create a new folder entitled emailusers in sites/all/modules

Step 2, in that folder, create emailusers.info, containing the following
(if you’ve read Notes 1-4 this should all be very familiar already):

;$Id$
name = “emailusers”
description = “admin module for emailing users from within their profile”
core = 6.x
php = 5.1

Step 3, create emailusers.module in same folder, contents thereof follow:

<?php

// $Id$
/**
* This module provides an email interface for administrators.
* Using this module, administrators can send email to a user from the
* user’s “view” page.
* @file
*/
/**
* Implementation hook_help()
*/
function emailusers_help($path, $arg){
if($path == ‘admin/help#emailusers’){
$txt = ‘This module provides a way for an administrator to send’
. ‘email to a user. ‘
. ‘It assumes that the Drupal mailer is configured.’;
return ‘<p>’ . t($txt) . ‘</p>’;
}
}
/**
* Implementation of hook_munu()
*/
function emailusers_menu(){
// Need to pass User ID via placeholder %,
// thus URL will be available here: ?q=admin/emailusers/compose/userIdHere
$items['admin/emailusers/compose/%'] = array(
‘title’ => ‘Compose a Message’,
‘page callback’ => ‘emailusers_compose’,
‘page arguments’ => array(3), // <- userId (from % in node path)
‘access arguments’ => array(‘administer users’),
‘type’ => MENU_CALLBACK,
);
return $items;
}
/**
* Compose a message.
* This creates the form necessary to compose an email message.
*
* @param $to
* The address to send to.
* @return
* HTML.
*/
function emailusers_compose($userid){
$userid = intval($userid);
if($userid == 0){
return t(‘User ID must be an integer.’);
}
$account = user_load($userid);
if(empty($account)){
return t(‘No such user found.’);
}
$to = $account->mail;
$sb = ‘<p>’
. t(‘Send a message to @email.’, array(‘@email’ => $to))
. ‘</p>’;
$sb .= drupal_get_form(‘emailusers_compose_form’, $account);
// Forms API / FAPI
// http://drupal.org/node/751826
// http://api.drupal.org/api/drupal/developer–topics–forms_api_reference.html/6
return $sb;
}
/**
* Form constructor
*/
function emailusers_compose_form($context, $account){
// This is a value only — equivalent to a hidden field
// except that it is never renered into the HTML
$form['to'] = array(
‘#type’ => ‘value’,
‘#value’ => $account,
);
// Create a fieldset for the body:
$form['message'] = array(
‘#type’ => ‘fieldset’,
‘#title’ => t(‘Compose the Message’),
);
// Textfield for subject of the body
$form['message']['subject'] = array(
‘#type’ => ‘textfield’,
‘#title’ => t(‘Subject’),
‘#size’ => 50,
‘#maxlength’ => 255,
‘#description’ => t(‘The subject of the email message.’),
);
// And a text area for the body.
$form['message']['body'] = array(
‘#type’ => ‘textarea’,
‘#title’ => t(‘Message’),
‘#cols’ => 50,
‘#rows’ => 5,
‘#description’ => t(‘The body of the email message.’),
);
// Create a fieldset for details
$form['details'] = array(
‘#type’ => ‘fieldset’,
‘#title’ => t(“Details”),
);
// Checkbox: if checked, CC the author too
$form['details']['cc_me'] = array(
‘#type’ => ‘checkbox’,
‘#title’ => t(‘BCC Yourself’),
‘#default_value’ => 1,
‘#description’ => t(‘If this is checked, the message will also be sent to you.’),
);
// Finally, a submit button:
$form['submit'] = array(
‘#type’ => ‘submit’,
‘#value’ => t(‘Send Mail’),
);
return $form;
}
/**
* Form submission handler, which functions like a hook.
* Note that the params $form and &$form_state are new in D6.
* They replace $form_id and $form_values.
*/
function emailusers_compose_form_submit($form, &$form_state){
$form_values = $form_state['values'];
$account = $form_values['to'];
drupal_mail(
‘emailusers’,
‘composemessage’,
$account->mail,
user_preferred_language($account),
$form_values,
variable_get(‘site_mail’, null),
true // Automatically send
);
// drupal_mail will invoke hook_mail(), or in this case, emailusers_mail(), below
$form_state['redirect'] = sprintf(‘user/%d’, $account->uid);
}
/**
* Implementation of hook_mail()
*/
function emailusers_mail($key, &$message, $params){
// Just catch calls to this hook from compose form.
if ($key == ‘composemessage’){
$language = $params['language'];
$account = $params['to'];
if($params['cc_me']){
// Look up current user’s email address:
//$my_account = user_load(null);
$message['headers']['bcc'] = $GLOBALS['user']->mail;
}
$message['to'] = $account->mail;
$message['subject'] = t(‘Drupal Message: ‘, array(), $language->language);
// If these were automatically-generated messages
// they should be run through t()
// but since text is user-entered
// don’t use t()
$message['subject'] .= $params['subject'];
//$message['body'] = $params['body'];
$message['body'][] = $params['body'];
}
}
/**
* Implements hook_mail_alter()
* !! Note: similar, and also of interest are hook_link_alter() & hook_menu_alter()
* simply put, _alter hooks alter data right after their parent hooks are called, but before output
* also important to note: this _alter() below will augment ALL emails sent to the Mail API
* not just those from this module!
*/
function emailusers_mail_alter(&$message){
$append = “\n==================================\n”
. “This message was sent from !site_name (!website). ”
. “If you believe this message to be a case of abuse, ”
. “please contact !site_email.\n”;
$args = array(
‘!website’ => url(”, array(‘absolute’ => true)),
‘!site_email’ => variable_get(‘site_mail’, null),
‘!site_name’ => variable_get(‘site_name’, ‘Unknown’),
);
$message['body'] .= t($append, $args);
//$message['body'][] = t($append, $args);
}
/**
* Implementation of hook_user().
*/
function emailusers_user($op, &$edit, &$account, $category){
if($op == ‘view’ && user_access(‘administer users‘)){
// Create the outer “block”
$account->content['EmailUsers'] = array(
‘#type’ => ‘user_profile_category‘,
‘#attributes’ => array(‘class’ => ‘user-member’),
‘#weight’ => 0,
‘#title’ => t(‘Contact user’),
);
// Create the content of the block
$account->content['EmailUsers']['EmailLink'] = array(
‘#type’ => ‘user_profile_item‘,
‘#title’ => t(‘Send a message to this user from the site administrator.’),
‘#value’ => l(
‘Email’,
‘admin/emailusers/compose/’ . $account->uid
),
);
}
}

var quoteDisplay = {}; // JS Namespace Object Creation
if(Drupal.jsEnabled){
$(document).ready(
function(){
$(“#quoteDisplay-origin”).after(“<a>Next &raquo;</a>”).next().click(quoteDisplay.randQuote);
}
);
/**
* A function to fetch quotes from the server,
* and display in the designated area.
*/
quoteDisplay.randQuote = function(){
$.get(Drupal.settings.quoteDisplay.json_url, function(data){
myQuote = Drupal.parseJson(data);
if(!myQuote.status || myQuotes.status == 0){
$(“#quoteDisplay-origin”).text(myQuote.quote.origin);
$(“#quoteDisplay-text”).text(myQuote.quote.text);
}
}); // End inline function
}
}

add this line to quoteDisplay.module file’s theme_quoteDisplay() function (after “drupal_add_js” line, before “$output = ‘

drupal_add_js($module_path . ‘/quoteDisplay.js’);
$opts = array(‘absolute’ => TRUE);
$json_url = url(‘quoteDisplay.json’, $opts);
drupal_add_js(
array(‘quoteDisplay’ =>
array(“json_url” => $json_url)), ‘setting‘);

also add these functions to our quoteDisplay.module file:

/*
* Callback to handle requests for quoteDisplay content.
* @return
* JSON data.
*/
function quoteDisplay_item(){
$item = _quoteDisplay_get_quote();
drupal_set_header(‘Content-Type: text/plain; charset: utf-8′);
printf(
‘{ “quote”: { “origin”: “%s”, “text”: “%s” } }‘,
$item->title,
$item->body
);
}

/**
* Implementation of hook_menu()
* registers quoteDisplay.json
* will call quoteDisplay_item() when called
* anyone that may access content may access this path
* MENU_CALLBACK below is a bitmask,
* that doesn’t authomatically create links to this item in the menu or elsewhere,
* it simnply makes this accessible by URL,
* more than 20 such bitmask types may be used,
* see documentation.
*/
function quoteDisplay_menu(){
$items['quoteDisplay.json'] = array(
‘title’ => ‘Quote Display AJAX Gateway’,
‘page callback’ => ‘quoteDisplay_item’,
‘access arguments’ => array(‘access content’),
‘type’ => MENU_CALLBACK,
);
return $items;
}

now hit the url to see your JSON return! (you may need to clear your drupal cache of course)
http://localhost/yourDrupalSiteName/?q=quoteDisplay.json

quoteDisplay.info contains the following:

; $Id$
name = “Quote Display”
description = “Dynamic display of  quotes.”
core = 6.x
php = 5.1

quoteDisplay.module contains this:

<?php

// $Id$
/**
* @file
* Module for dynamic display of pithy philosophy quotes.
*/

/**
* Implementation of hook_help()
*/
function quoteDisplay_help($path, $arg)
{
if ($path == ‘admin/help#quoteDisplay’)
{
$txt = ‘This module displays philosophical quotes in blocks. ‘ .
‘It assumes the existence of a content type named “quote”.’;
return ‘<p>’ . t($txt) . ‘</p>’;
}
}

/**
* Implementation of hook_block()
*/
function quoteDisplay_block($op = ‘list’, $delta = 0, $edit = array())
{
switch($op)
{
case ‘list’:
$blocks[0]['info'] = t(‘Philosophical Quotes’);
return $blocks;
case ‘view’:
$item = _quoteDisplay_get_quote();
if(!empty($item))
{
$content = theme(‘quoteDisplay_quote’,
check_plain($item->body),
check_plain($item->title));
$blocks['subject'] = t(‘Pithy Quote’);
$blocks['content'] = $content;
return $blocks;
}
}
}

/*
* Return a quote from the Drupal database
*/
function _quoteDisplay_get_quote()
{
$sql = “SELECT nid FROM {node} “.
“WHERE status = 1 AND type = ‘quote’ ORDER BY RAND() LIMIT 1″;
$res = db_query($sql);
$item = db_fetch_object($res);
$quote = node_load($item->nid);
return $quote;
}

/*
* Implementation of hook_theme().
*/
function quoteDisplay_theme()
{
return array(
‘quoteDisplay_quote’ => array(
‘arguments’ => array(
‘text’ => NULL,
‘origin’ => NULL
),
),
);
}

/*
* Theme function for theming quotes.
*
* @param $text
* The quote content as a string.
* @param $origin
* The original source of the quote, as a string.
* @return
* An HTML themed string.
*/
function theme_quoteDisplay_quote($text, $origin)
{
$module_path = drupal_get_path(‘module’,’quoteDisplay‘);
$full_path = $module_path . ‘/quoteDisplay.css’;
drupal_add_css($full_path);
$output = ‘<div id=”quoteDisplay-text”>’ . t($text) . ‘</div><div id=”quoteDisplay-origin”>’ . t($origin) . ‘</div>’;
return $output;
}

quoteDisplay.css (also in /sites/all/modules/quoteDisplay) contains:

#quoteDisplay-text:first-letter{
font-size:18pt;
font-weight:bold;
}
#quoteDisplay-origin{
font-style: oblique;
text-align: right;
margin-right: 5px;
}

Note:

This module thus has a default “theme” of its own.  This may be overridden via CSS, or via a quoteDisplay.tpl.php file placed within the themes/module/currentTheme folder

<?php
class Foo
{
function Simple()
{
$var = “Hello”;
return $var;
}
}
?>

namespace.php

<?php
namespace Second;
include(‘Foo.class.php’);

class Foo
{
function Simple()
{
$var = “Hello in Second Namespace<br />”;
return $var;
}
}

$fooSecond = new \Second\Foo();
echo $fooSecond->Simple();
//option 1
//$fooFirst = new \Foo();
//$fooFirst->Simple();
//option 2
echo \Foo::Simple();
?>

<?php
class Foo
{
public static $varz;
public static function Simple()
{
self::$varz = “Hello”;
return self::$varz;
}
}
?>

index.php (in the same directory)

<?php
function __autoload($classname) {
include(“$classname.class.php”);
}

//include “Foo.class.php”; //no longer needed!

$foo = new Foo();
echo $foo->Simple();
?>

<?php
ob_start();
print “Hello First!\n”;
ob_end_flush();

ob_start();
print “Hello Second!\n”;
ob_end_clean();

ob_start();
print “Hello Third!\n”;
?>

//outputs “Hello First! Hello Third!”

//flush()

<HTML>
<BODY>
<DIV ID=”flushme”>
Hello, world!
</DIV>
<?php flush(); sleep(2); ?>
<SCRIPT>
d = document.getElementById(“flushme”);
d.innerHTML = “Goodbye, Perl!”;
</SCRIPT>
<?php flush(); sleep(2); ?>
<SCRIPT>
d.innerHTML = “Goodnight, New York!”;
</SCRIPT>
</BODY>
</HTML>

// compressed output

<?php
ob_start(‘ob_gzhandler’);
print “My content\n”;
ob_end_flush();
?>

// sleep

<?php
ob_implicit_flush(true);
for($i=0;$i<5;$i++)
{
$dis=<<<DIS
<div style=”width:200px; background-color:lime;border:1px; text-align:center;text-decoration:blink;”>
$i
</div>
DIS;
echo $dis;

sleep(5);
//flush();
}
?>

Chain of responsibility:
http://en.wikipedia.org/wiki/Chain-of-responsibility_pattern
Polymorphism:
http://en.wikipedia.org/wiki/Polymorphism_in_object-oriented_programming
JavaScript really OOP?:
http://articles.techrepublic.com.com/5100-10878_11-1044656.html
http://mckoss.com/jscript/object.htm
JS Prototype object:
http://www.javascriptkit.com/javatutors/proto4.shtml
Design Patterns reference/list:
http://en.wikipedia.org/wiki/Design_pattern_%28computer_science%29
Decorator Pattern:
http://en.wikipedia.org/wiki/Decorator_pattern
Loose Coupling def:
http://en.wikipedia.org/wiki/Loose_coupling
Singleton Pattern:
http://en.wikipedia.org/wiki/Singleton_pattern

while($get_cp_data_array = mysql_fetch_array($get_cp_data)){
$q_id = $get_cp_data_array['questionId'];

$q_fname = $get_cp_data_array['customerFName'];
$q_lname = $get_cp_data_array['customerLName'];
$q_email = $get_cp_data_array['customerEmail'];

$q_topic = $get_cp_data_array['questionTopic'];
$q_question = $get_cp_data_array['question'];
$q_date = $get_cp_data_array['questionDate'];
//$q_count = $get_cp_data_array['votecount'];
$q_customer = $get_cp_data_array['customerId'];

if($q_topic == “”){ $q_topic = “–”; }
if($q_fname != “” || $q_lname != “”){
$from = ‘<strong>’ . $q_fname . ‘ ‘ . $q_lname . ‘</strong> – ‘;
}

# Parse the question text.
$old = array(“\n”);
$new   = array(“<br/>”);
$q_question = str_replace($old, $new, $q_question);

# Output the question.
$cp_output = $cp_output . ‘
<div>’ . $q_id . ‘</div>
<div>
<div><strong>’ . $q_topic . ‘</strong></div>
<div>’ . $q_question . ‘</div>
<div><strong>Submitted</strong> ‘ . $q_date . ‘ by ‘ . $from . ‘<a href=”mailto:’ . $q_email . ‘”>’ . $q_email . ‘</a></div>
</div>
<div></div>
‘;
}

echo “<pre>”;
print_r($_SERVER);

?>

and start making whatever you need.  It’s a nice clean place to put things without hacking away at your code,

dynamically inserting with JS, or whatever other measure you’ve either employed in the past, or are considering now…

for example,

<?php
//My own footer hook
function my_footer() {

//code to execute

?><div class=”bigText”>blah blah blah</div><?

}

?>

then, wherever you like, call your new function, example, replace all <? wp_footer(); ?> calls with, you guested it, <? my_footer(); ?>

thanks to: http://www.raymondselda.com/understanding-action-hooks-in-wordpress/

Don’t forget to include the following in your new custom theme functions.php file if you want the dynamic custom drag widget sidebar!:

if ( function_exists(‘register_sidebar’) )
register_sidebar();

reference: http://codex.wordpress.org/Widgetizing_Themes

$original = “foo”;
$ref = &$original;
echo $ref; \\Prints “foo”
// now we change the value of $original
$original = “bar”;
// and then print the value of the referring variable
echo $ref; \\Now prints the new value: “bar”
source: http://www.whypad.com/posts/php-what-is-the-ampersand-preceding-variables/193/

reference variable (&variable)

Basically, the argument is treated, referenced by the outside variable, as global
Without the &, it would output ‘This is a string’
source: http://php.net/manual/en/functions.arguments.php

http://w3schools.com/php/php_ajax_php.asp

HTML:

<html>
<head>
<script type=”text/javascript”>
function showHint(str)
{
if (str.length==0)
{
document.getElementById(“txtHint”).innerHTML=”";
return;
}
if (window.XMLHttpRequest)
{// code for IE7+, Firefox, Chrome, Opera, Safari
xmlhttp=new XMLHttpRequest();
}
else
{// code for IE6, IE5
xmlhttp=new ActiveXObject(“Microsoft.XMLHTTP”);
}
xmlhttp.onreadystatechange=function()
{
if (xmlhttp.readyState==4 && xmlhttp.status==200)
{
document.getElementById(“txtHint”).innerHTML=xmlhttp.responseText;
}
}
xmlhttp.open(“GET”,”gethint.php?q=”+str,true);
xmlhttp.send();
}
</script>
</head
<body>

<p><b>Start typing a name in the input field below:</b></p>
<form>
First name: <input type=”text” onkeyup=”showHint(this.value)” size=”20″ />
</form>
<p>Suggestions: <span id=”txtHint”></span></p>

</body>
</html>

Script:

<?php
// Fill up array with names
$a[]=”Anna”;
$a[]=”Brittany”;
$a[]=”Cinderella”;
$a[]=”Diana”;
$a[]=”Eva”;
$a[]=”Fiona”;
$a[]=”Gunda”;
$a[]=”Hege”;
$a[]=”Inga”;
$a[]=”Johanna”;
$a[]=”Kitty”;
$a[]=”Linda”;
$a[]=”Nina”;
$a[]=”Ophelia”;
$a[]=”Petunia”;
$a[]=”Amanda”;
$a[]=”Raquel”;
$a[]=”Cindy”;
$a[]=”Doris”;
$a[]=”Eve”;
$a[]=”Evita”;
$a[]=”Sunniva”;
$a[]=”Tove”;
$a[]=”Unni”;
$a[]=”Violet”;
$a[]=”Liza”;
$a[]=”Elizabeth”;
$a[]=”Ellen”;
$a[]=”Wenche”;
$a[]=”Vicky”;

//get the q parameter from URL
$q=$_GET["q"];

//lookup all hints from array if length of q>0
if (strlen($q) > 0)
{
$hint=”";
for($i=0; $i<count($a); $i++)
{
if (strtolower($q)==strtolower(substr($a[$i],0,strlen($q))))
{
if ($hint==”")
{
$hint=$a[$i];
}
else
{
$hint=$hint.” , “.$a[$i];
}
}
}
}

// Set output to “no suggestion” if no hint were found
// or to the correct values
if ($hint == “”)
{
$response=”no suggestion”;
}
else
{
$response=$hint;
}

//output the response
echo $response;
?>

example XML

<?xml version=”1.0″ encoding=”ISO-8859-1″?>
<note>
<to>Tove</to>
<from>Jani</from>
<heading>Reminder</heading>
<body>Don’t forget me this weekend!</body>
</note>

script to parse:

<?php
//Initialize the XML parser
$parser=xml_parser_create();

//Function to use at the start of an element
function start($parser,$element_name,$element_attrs)
{
switch($element_name)
{
case “NOTE”:
echo “– Note –<br />”;
break;
case “TO”:
echo “To: “;
break;
case “FROM”:
echo “From: “;
break;
case “HEADING”:
echo “Heading: “;
break;
case “BODY”:
echo “Message: “;
}
}

//Function to use at the end of an element
function stop($parser,$element_name)
{
echo “<br />”;
}

//Function to use when finding character data
function char($parser,$data)
{
echo $data;
}

//Specify element handler
xml_set_element_handler($parser,”start”,”stop”);

//Specify data handler
xml_set_character_data_handler($parser,”char”);

//Open XML file
$fp=fopen(“test.xml”,”r”);

//Read data
while ($data=fread($fp,4096))
{
xml_parse($parser,$data,feof($fp)) or
die (sprintf(“XML Error: %s at line %d”,
xml_error_string(xml_get_error_code($parser)),
xml_get_current_line_number($parser)));
}

//Free the XML parser
xml_parser_free($parser);
?>

output:

– Note –
To: Tove
From: Jani
Heading: Reminder
Message: Don’t forget me this weekend!

http://w3schools.com/sql/sql_datatypes.asp

Order results by 2 columns:

SELECT column_name(s)
FROM table_name
ORDER BY column1, column2

Simple delete:

<?php
$con = mysql_connect(“localhost”,”peter”,”abc123″);
if (!$con)
{
die(‘Could not connect: ‘ . mysql_error());
}
mysql_select_db(“my_db”, $con);
mysql_query(“DELETE FROM Persons WHERE LastName=’Griffin’”);
mysql_close($con);
?>

<?php
//error handler function
function customError($errno, $errstr)
{
echo “<b>Error:</b> [$errno] $errstr<br />”;
echo “Webmaster has been notified”;
error_log(“Error: [$errno] $errstr”,1,
“someone@example.com”,”From: webmaster@example.com”);
}

//set error handler
set_error_handler(“customError”,E_USER_WARNING);

//trigger error
$test=2;
if ($test>1)
{
trigger_error(“Value must be 1 or below”,E_USER_WARNING);
}
?>