publication_date.api.php in Publication Date 8

API documentation for the Publication Date module.

File

publication_date.api.php

<?php

/**
 * @file
 * API documentation for the Publication Date module.
 */

/**
 * Allows modules to alter the publication date before it is saved to the
 * database on node update/insert.
 *
 * @param integer $published_at
 *   A Unix timestamp representing the publication date to be altered. If no
 *   publication date has been set then $published_at should equal the defined
 *   constant PUBLICATION_DATE_DEFAULT.
 * @param object $node
 *   The node object.
 * @param string $op
 *   The node opperation being performed:
 *   - 'insert': a new node was created
 *   - 'update': an existing node was updated
 */
function hook_publication_date_alter(&$published_at, $node, $op) {

  // Check if the node is being published.
  if ($node->status == 1) {

    // If a future publication date was set, change it to the curret time.
    $published_at = $published_at > REQUEST_TIME ? REQUEST_TIME : $published_at;
  }
}

Functions

Name	Description
hook_publication_date_alter	Allows modules to alter the publication date before it is saved to the database on node update/insert.