File Source for pnadminapi.php

<?php
/**
* Zikula Application Framework
*
* @copyright (c) 2002, Zikula Development Team
* @link http://www.zikula.org
* @version $Id: pnadminapi.php 24342 2008-06-06 12:03:14Z markwest $
* @license GNU/GPL - http://www.gnu.org/copyleft/gpl.html
* @package Zikula_Value_Addons
* @subpackage FAQ
*/
/**
* create a new FAQ
*
* @param $args['question'] name of the item
* @param $args['answer'] number of the item
* @param $args['submittedby'] name of the submitter (if anonymous) (optional)
* @param $args['submittedbyid'] id of the submitter (if logged in) (optional)
* @param $args['answeredbyid'] id of the answerer (optional)
* @return mixed FAQ ID on success, false on failure
*/
function FAQ_adminapi_create($faq)
{
// Argument check
if (!isset($faq['question']) ||
!isset($faq['answer'])) {
return LogUtil::registerError (_MODARGSERROR);
}
// optional arguments
if (!isset($faq['submittedby'])) {
$faq['submittedby'] = '';
}
if (!isset($faq['submittedbyid'])) {
$faq['submittedbyid'] = pnUserGetVar('uid');
}
if (!isset($faq['answeredbyid'])) {
if (strlen($faq['answer']) > 0) {
$faq['answeredbyid'] = $faq['submittedbyid'];
} else {
$faq['answeredbyid'] = '';
}
}
// define the permalink title if not present
if (!isset($faq['urltitle']) || empty($faq['urltitle'])) {
$faq['urltitle'] = DataUtil::formatPermalink($faq['question']);
}
// Security check
if (!SecurityUtil::checkPermission( 'FAQ::', '::', ACCESS_COMMENT)) {
return LogUtil::registerPermissionError();
}
if (!DBUtil::insertObject($faq, 'faqanswer', 'faqid')) {
return LogUtil::registerError (_CREATEFAILED);
}
// Let any hooks know that we have created a new item
pnModCallHooks('item', 'create', $faq['faqid'], array('module' => 'FAQ'));
// Return the id of the newly created item to the calling process
return $faq['faqid'];
}
/**
* delete an faq
*
* @param $args['faqid'] ID of the item
* @return bool true on success, false on failure
*/
function FAQ_adminapi_delete($args)
{
// Argument check
if (!isset($args['faqid']) || !is_numeric($args['faqid'])) {
return LogUtil::registerError (_MODARGSERROR);
}
// Get the current faq
$item = pnModAPIFunc('FAQ', 'user', 'get', array('faqid' => $args['faqid']));
if (!$item) {
return LogUtil::registerError (_NOSUCHITEM);
}
// Security check
if (!SecurityUtil::checkPermission( 'FAQ::', "$args[faqid]::", ACCESS_DELETE)) {
return LogUtil::registerPermissionError();
}
if (!DBUtil::deleteObjectByID('faqanswer', $args['faqid'], 'faqid')) {
return LogUtil::registerError (_DELETEFAILED);
}
// Let any hooks know that we have deleted an item
pnModCallHooks('item', 'delete', $args['faqid'], array('module' => 'FAQ'));
// The item has been deleted, so we clear all cached pages of this item.
$pnRender = pnRender::getInstance('FAQ');
$pnRender->clear_cache(null, $args['faqid']);
return true;
}
/**
* update an item
*
* @param $args['faqid'] the ID of the item
* @param $args['question'] the new name of the item
* @param $args['answer'] the new number of the item
* @param $args['submittedby'] name of the submitter (if anonymous)
* @param $args['submittedbyid'] id of the submitter (if logged in)
* @param $args['answeredbyid'] id of the answerer (optional)
* @return bool true on success, false on failure
*/
function FAQ_adminapi_update($faq)
{
// Argument check
if (!isset($faq['question']) ||
!isset($faq['answer']) ||
!isset($faq['faqid']) || !is_numeric($faq['faqid'])) {
return LogUtil::registerError (_MODARGSERROR);
}
// optional arguments
if (!isset($faq['answeredbyid'])) {
if (strlen($faq['answer']) > 0) {
$faq['answeredbyid'] = pnUserGetVar('uid');
} else {
$faq['answeredbyid'] = '';
}
}
// define the permalink title if not present
if (!isset($faq['urltitle']) || empty($faq['urltitle'])) {
$faq['urltitle'] = DataUtil::formatPermalink($faq['question']);
}
// Get the current faq
$item = pnModAPIFunc('FAQ', 'user', 'get', array('faqid' => $faq['faqid']));
if (!$item) {
return LogUtil::registerError (_NOSUCHITEM);
}
// Security check.
if (!SecurityUtil::checkPermission( 'FAQ::', "$faq[faqid]::", ACCESS_EDIT)) {
return LogUtil::registerPermissionError();
}
if (!DBUtil::updateObject($faq, 'faqanswer', '', 'faqid')) {
return LogUtil::registerError (_UPDATEFAILED);
}
// The item has been modified, so we clear all cached pages of this item.
$pnRender = pnRender::getInstance('FAQ');
$pnRender->clear_cache(null, $faq['faqid']);
// Let any hooks know that we have updated an item
pnModCallHooks('item', 'update', $faq['faqid'], array('module' => 'FAQ'));
return true;
}
/**
* get available admin panel links
*
* @author Mark West
* @return array array of admin links
*/
function FAQ_adminapi_getlinks()
{
$links = array();
pnModLangLoad('FAQ', 'admin');
if (SecurityUtil::checkPermission('FAQ::', '::', ACCESS_READ)) {
$links[] = array('url' => pnModURL('FAQ', 'admin', 'view'), 'text' => _FAQ_VIEW);
}
if (SecurityUtil::checkPermission('FAQ::', '::', ACCESS_ADD)) {
$links[] = array('url' => pnModURL('FAQ', 'admin', 'new'), 'text' => _FAQ_CREATE);
}
if (SecurityUtil::checkPermission('FAQ::', '::', ACCESS_ADMIN)) {
$links[] = array('url' => pnModURL('FAQ', 'admin', 'modifyconfig'), 'text' => _MODIFYCONFIG);
}
return $links;
}

Source for file pnadminapi.php