Source for file _chapter.class.php

Documentation is available at _chapter.class.php

<?php
/**
* This file implements the Chapter class.
*
* This file is part of the evoCore framework - {@link http://evocore.net/}
* See also {@link http://sourceforge.net/projects/evocms/}.
*
* Parts of this file are copyright (c)2005-2006 by PROGIDISTRI - {@link http://progidistri.com/}.
*
* {@internal License choice
* - If you have received this file as part of a package, please find the license.txt file in
* the same folder or the closest folder above for complete license terms.
* - If you have received this file individually (e-g: from http://evocms.cvs.sourceforge.net/)
* then you must choose one of the following licenses before using the file:
* - GNU General Public License 2 (GPL) - http://www.opensource.org/licenses/gpl-license.php
* - Mozilla Public License 1.1 (MPL) - http://www.opensource.org/licenses/mozilla1.1.php
* }}}
*
* @package evocore
*
* {@internal Below is a list of authors who have contributed to design/coding of this file: }}
* @author fplanque: Francois PLANQUE.
*
* @version $Id: _chapter.class.php,v 1.16 2010/02/08 17:52:07 efy-yury Exp $
*/
if( !defined('EVO_MAIN_INIT') ) die( 'Please, do not access this page directly.' );
load_class( 'generic/model/_genericcategory.class.php', 'GenericCategory' );
/**
* Chapter Class
*
* @package evocore
*/
class Chapter extends GenericCategory
{
/**
* @var integer
*/
var $blog_ID;
/**
* The Blog of the Item (lazy filled, use {@link get_Blog()} to access it.
* @access protected
* @var Blog
*/
var $Blog;
var $urlname;
var $description;
var $order;
/**
* Lazy filled
* @var Chapter
*/
var $parent_Chapter;
/**
* Constructor
*
* @param table Database row
* @param integer|NULLsubset to use for new object
*/
function Chapter( $db_row = NULL, $subset_ID = NULL )
{
// Call parent constructor:
parent::GenericCategory( 'T_categories', 'cat_', 'cat_ID', $db_row );
if( is_null($db_row) )
{ // We are creating an object here:
$this->set( 'blog_ID', $subset_ID );
}
else
{ // Wa are loading an object:
$this->blog_ID = $db_row->cat_blog_ID;
$this->urlname = $db_row->cat_urlname;
$this->description = $db_row->cat_description;
$this->order = $db_row->cat_order;
}
}
/**
* Load data from Request form fields.
*
* @return boolean true if loaded data seems valid.
*/
function load_from_request()
{
global $DB, $Settings;
parent::load_from_Request();
// Check url name
param( 'cat_urlname', 'string' );
$this->set_from_Request( 'urlname' );
// Check description
param( 'cat_description', 'string' );
$this->set_from_Request( 'description' );
if( $Settings->get('chapter_ordering') == 'manual' )
{ // Manual ordering
param( 'cat_order', 'integer' );
$this->set_from_Request( 'order' );
}
return ! param_errors_detected();
}
/**
*
*/
function & get_parent_Chapter()
{
if( ! isset( $this->parent_Chapter ) )
{ // Not resoleved yet!
if( empty( $this->parent_ID ) )
{
$this->parent_Chapter = NULL;
}
else
{
$ChapterCache = & get_ChapterCache();
$this->parent_Chapter = & $ChapterCache->get_by_ID( $this->parent_ID );
}
}
return $this->parent_Chapter;
}
/**
* Get URL path (made of URL names) back to the root
*/
function get_url_path()
{
$r = $this->urlname.'/';
$parent_Chapter = & $this->get_parent_Chapter();
if( !is_null( $parent_Chapter ) )
{ // Recurse:
$r = $parent_Chapter->get_url_path().$r;
}
return $r;
}
/**
* Generate the URL to access the category.
*
* @param string|NULL'param_num', 'subchap', 'chapters'
* @param string|NULLurl to use
* @param integer category page to link to, default:1
* @param integer|NULLnumber of posts per page (used for param_num only)
* @param string glue between url params
*/
function get_permanent_url( $link_type = NULL, $blogurl = NULL, $paged = 1, $chapter_posts_per_page = NULL, $glue = '&' )
{
global $DB, $cacheweekly, $Settings;
if( empty( $link_type ) )
{ // Use default from settings:
$this->get_Blog();
$link_type = $this->Blog->get_setting( 'chapter_links' );
}
if( empty( $blogurl ) )
{
$this->get_Blog();
$blogurl = $this->Blog->gen_blogurl();
}
switch( $link_type )
{
case 'param_num':
$r = url_add_param( $blogurl, 'cat='.$this->ID, $glue );
if( empty($chapter_posts_per_page) )
{ // Use default from Blog
$this->get_Blog();
$chapter_posts_per_page = $this->Blog->get_setting( 'chapter_posts_per_page' );
}
if( !empty($chapter_posts_per_page) && $chapter_posts_per_page != $this->Blog->get_setting( 'posts_per_page' ) )
{ // We want a specific post per page count:
$r = url_add_param( $r, 'posts='.$chapter_posts_per_page, $glue );
}
break;
case 'subchap':
$this->get_Blog();
$category_prefix = $this->Blog->get_setting('category_prefix');
if( !empty( $category_prefix ) )
{
$r = url_add_tail( $blogurl, '/'.$category_prefix.'/'.$this->urlname.'/' );
}
else
{
$r = url_add_tail( $blogurl, '/'.$this->urlname.'/' );
}
break;
case 'chapters':
default:
$this->get_Blog();
$category_prefix = $this->Blog->get_setting('category_prefix');
if( !empty( $category_prefix ) )
{
$r = url_add_tail( $blogurl, '/'.$category_prefix.'/'.$this->get_url_path() );
}
else
{
$r = url_add_tail( $blogurl, '/'.$this->get_url_path() );
}
break;
}
if( $paged > 1 )
{
$r = url_add_param( $r, 'paged='.$paged, $glue );
}
return $r;
}
/**
* Get the Blog object for the Chapter.
*
* @return Blog
*/
function & get_Blog()
{
if( is_null($this->Blog) )
{
$this->load_Blog();
}
return $this->Blog;
}
/**
* Load the Blog object for the Chapter, without returning it.
*/
function load_Blog()
{
if( is_null($this->Blog) )
{
$BlogCache = & get_BlogCache();
$this->Blog = & $BlogCache->get_by_ID( $this->blog_ID );
}
}
/**
* Insert object into DB based on previously recorded changes.
*
* @return boolean true on success
*/
function dbinsert()
{
global $DB;
load_funcs( 'items/model/_item.funcs.php' );
if( $this->ID != 0 ) die( 'Existing object cannot be inserted!' );
$DB->begin();
// validate url title / slug
$this->set( 'urlname', urltitle_validate( $this->urlname, $this->name, $this->ID, false, $this->dbprefix.'urlname', $this->dbIDname, $this->dbtablename) );
$r = parent::dbinsert();
$DB->commit();
return $r;
}
/**
* Update the DB based on previously recorded changes
*
* @return boolean true on success
*/
function dbupdate()
{
global $DB;
$DB->begin();
// validate url title / slug
if( empty($this->urlname) || isset($this->dbchanges['cat_urlname']) )
{ // Url title has changed or is empty
$this->set( 'urlname', urltitle_validate( $this->urlname, $this->name, $this->ID, false, $this->dbprefix.'urlname', $this->dbIDname, $this->dbtablename) );
}
$r = parent::dbupdate();
$DB->commit();
return $r;
}
}
/*
* $Log: _chapter.class.php,v $
* Revision 1.16 2010/02/08 17:52:07 efy-yury
*
* Revision 1.15 2009/10/04 20:36:04 blueyed
* Add missing load_funcs
*
* Revision 1.14 2009/09/26 12:00:42 tblue246
* Minor/coding style
*
* Revision 1.13 2009/09/25 07:32:52 efy-cantor
* replace get_cache to get_*cache
*
* Revision 1.12 2009/09/14 12:26:25 efy-arrin
* Included the ClassName in load_class() call with proper UpperCase
*
* Revision 1.11 2009/03/08 23:57:41 fplanque
* 2009
*
* Revision 1.10 2009/01/28 21:23:22 fplanque
* Manual ordering of categories
*
* Revision 1.9 2008/12/28 23:35:51 fplanque
* Autogeneration of category/chapter slugs(url names)
*
* Revision 1.8 2008/01/21 09:35:26 fplanque
* (c) 2008
*
* Revision 1.7 2008/01/07 02:53:27 fplanque
* cleaner tag urls
*
* Revision 1.6 2007/11/25 14:28:17 fplanque
* additional SEO settings
*
* Revision 1.5 2007/10/06 21:17:25 fplanque
* cleanup
*
* Revision 1.4 2007/10/01 13:41:06 waltercruz
* Category prefix, trying to make the code more b2evo style
*
* Revision 1.3 2007/09/29 01:50:49 fplanque
* temporary rollback; waiting for new version
*
* Revision 1.1 2007/06/25 10:59:25 fplanque
* MODULES (refactored MVC)
*
* Revision 1.10 2007/05/09 00:54:45 fplanque
* Attempt to normalize all URLs before adding params
*
* Revision 1.9 2007/04/26 00:11:06 fplanque
* (c) 2007
*
* Revision 1.8 2007/03/02 00:44:43 fplanque
* various small fixes
*
* Revision 1.7 2007/01/15 00:38:06 fplanque
* pepped up "new blog" creation a little. To be continued.
*
* Revision 1.6 2006/12/11 00:32:26 fplanque
* allow_moving_chapters stting moved to UI
* chapters are now called categories in the UI
*
* Revision 1.5 2006/11/24 18:27:23 blueyed
* Fixed link to b2evo CVS browsing interface in file docblocks
*/
?>

Multilingual multiuser multiblog engine

Source for file _chapter.class.php

Packages