publishcontent.api.php in Publish Content 7
Describe hooks provided by the publishcontent module.
File
publishcontent.api.phpView source
<?php
/**
* @file
* Describe hooks provided by the publishcontent module.
*/
/**
* Allow other modules the ability to modify access to the publish controls.
*
* Modules may implement this hook if they want to have a say in whether or not
* a given user has access to perform publish action on a node.
*
* @param node $node
* A node object being checked
* @param user $account
* The user wanting to publish the node.
*
* @return bool|NULL
* PUBLISHCONTENT_ACCESS_ALLOW - if the account can publish the node
* PUBLISHCONTENT_ACCESS_DENY - if the user definitely can not publish
* PUBLISHCONTENT_ACCESS_IGNORE - This module wan't change the outcome.
* It is typically better to return IGNORE than DENY. If no module returns
* ALLOW then the account will be denied publish access. If one module
* returns DENY then the user will denied even if another module returns
* ALLOW.
*/
function hook_publishcontent_publish_access($node, $account) {
$access = !$node->status && (user_access('administer nodes') || user_access('publish any content') || user_access('publish own content') && $account->uid == $node->uid || user_access('publish editable content') && node_access('update', $node) || user_access('publish own ' . check_plain($node->type) . ' content', $account) && $account->uid == $node->uid || user_access('publish any ' . check_plain($node->type) . ' content') || user_access('publish editable ' . check_plain($node->type) . ' content') && node_access('update', $node));
if ($access) {
// The user can publish the node according to this hook.
// If another hook denys access they will be denied.
return PUBLISHCONTENT_ACCESS_ALLOW;
}
// This function does not believe they can publish but is
// not explicitly denying access to publish. If no other hooks
// allow it then the user will be denied.
return PUBLISHCONTENT_ACCESS_IGNORE;
}
/**
* Allow other modules the ability to modify access to the unpublish controls.
*
* Modules may implement this hook if they want to have a say in whether or not
* a given user has access to perform unpublish action on a node.
*
* @param node $node
* A node object being checked
* @param user $account
* The user wanting to unpublish the node.
*
* @return bool|NULL
* PUBLISHCONTENT_ACCESS_ALLOW - if the user can unpublish the node.
* PUBLISHCONTENT_ACCESS_DENY - if the user definetley cannot unpublish.
* PUBLISHCONTENT_ACCESS_IGNORE - This module wan't change the outcome.
* It is typically better to return IGNORE than DENY. If no module returns
* ALLOW then the user will be denied access. If one module returns
* DENY then the user will denied even if another module returns
* ALLOW.
*/
function hook_publishcontent_unpublish_access($node, $account) {
$access = $node->status && (user_access('administer nodes') || user_access('unpublish any content') || user_access('unpublish own content') && $user->uid == $node->uid || user_access('unpublish editable content') && node_access('update', $node) || user_access('unpublish own ' . check_plain($node->type) . ' content', $user) && $user->uid == $node->uid || user_access('unpublish any ' . check_plain($node->type) . ' content') || user_access('unpublish editable ' . check_plain($node->type) . ' content') && node_access('update', $node));
if ($access) {
// The user is allowed to unpublish the node according to this hook.
// If another hook denys access they will be denied.
return PUBLISHCONTENT_ACCESS_ALLOW;
}
// This function does not believe they can publish but is
// not explicitly denying access to publish. If no other hooks
// allow it then the user will be denied.
return PUBLISHCONTENT_ACCESS_IGNORE;
}
Functions
Name | Description |
---|---|
hook_publishcontent_publish_access | Allow other modules the ability to modify access to the publish controls. |
hook_publishcontent_unpublish_access | Allow other modules the ability to modify access to the unpublish controls. |