administrator/components/com_categories/admin.categories.php-Dateireferenz

gehe zum Quellcode dieser Datei

Namensbereiche
namespace	Joomla
Aufzählungen
enum	COM_IMAGE_BASE
Funktionen
	accessMenu ($uid, $access, $section)
	cancelCategory ()
	copyCategorySave ($cid, $sectionOld)
	copyCategorySelect ($option, $cid, $sectionOld)
	editCategory ($uid=0, $section='')
	menuLink ($id)
	moveCategorySave ($cid, $sectionOld)
	moveCategorySelect ($option, $cid, $sectionOld)
	orderCategory ($uid, $inc)
	publishCategories ($section, $categoryid=null, $cid=null, $publish=1)
	recursive_listdir ($base)
	removeCategories ($section, $cid)
	saveCategory ($task)
	saveOrder (&$cid, $section)
	showCategories ($section, $option)
Variablen
	$cid = josGetArrayInts( 'cid' )
case	$id
default	$option
	$section = stripslashes( strval( mosGetParam( $_REQUEST, 'section', 'content' ) ) )
case	__pad0__
case	__pad10__
case	__pad11__
case	__pad12__
case	__pad13__
case	__pad14__
case	__pad15__
case	__pad16__
default	__pad17__
case	__pad1__
case	__pad2__
case	__pad3__
case	__pad4__
case	__pad5__
case	__pad6__
case	__pad7__
case	__pad8__
case	__pad9__
	break

---

Dokumentation der Aufzählungstypen

enum COM_IMAGE_BASE

Definiert in Zeile 20 der Datei admin.categories.php.

---

Dokumentation der Funktionen

accessMenu	(	$	uid,
		$	access,
		$	section
	)

changes the access level of a record

Parameter:

integer

The increment to reorder by

Definiert in Zeile 990 der Datei admin.categories.php.

Benutzt $access, $database, $row, $section, mosCache::cleanCache() und mosRedirect().

                                               {
        global $database;

        $row = new mosCategory( $database );
        $row->load( (int)$uid );
        $row->access = $access;

        if ( !$row->check() ) {
                return $row->getError();
        }
        if ( !$row->store() ) {
                return $row->getError();
        }

        if ($section == 'content') {
                // clean any existing cache files
                mosCache::cleanCache( 'com_content' );
        }

        mosRedirect( 'index2.php?option=com_categories&section='. $section );
}

Hier ist ein Graph der zeigt, was diese Funktion aufruft:

cancelCategory

(

)

Cancels an edit operation

Parameter:

	string	The name of the category section
	integer	A unique category id

Definiert in Zeile 725 der Datei admin.categories.php.

Benutzt $database, $row, josSpoofCheck(), mosGetParam() und mosRedirect().

                          {
        global $database;
        
        josSpoofCheck();

        $redirect = strval( mosGetParam( $_POST, 'redirect', '' ) );

        $row = new mosCategory( $database );
        $row->bind( $_POST );
        $row->checkin();

        mosRedirect( 'index2.php?option=com_categories&section='. $redirect );
}

Hier ist ein Graph der zeigt, was diese Funktion aufruft:

copyCategorySave	(	$	cid,
		$	sectionOld
	)

Save the item(s) to the menu selected

Definiert in Zeile 915 der Datei admin.categories.php.

Benutzt $cid, $content, $database, $id, $msg, $total, mosCache::cleanCache(), josGetArrayInts(), josSpoofCheck(), mosGetParam(), mosRedirect() und NULL.

                                               {
        global $database;
        
        josSpoofCheck();

        $sectionMove    = intval( mosGetParam( $_REQUEST, 'sectionmove', '' ) );
        if ( !$sectionMove ) {
                mosRedirect( 'index.php?option=com_categories&mosmsg=An error has occurred' );
        }

        $contentid              = josGetArrayInts( 'item', $_REQUEST );
        $total                  = count( $contentid  );

        $category = new mosCategory ( $database );
        foreach( $cid as $id ) {
                $category->load( (int)$id );
                $category->id           = NULL;
                $category->title        = 'Copy of '. $category->title;
                $category->name         = 'Copy of '. $category->name;
                $category->section      = $sectionMove;
                if (!$category->check()) {
                        echo "<script> alert('".$category->getError()."'); window.history.go(-1); </script>\n";
                        exit();
                }

                if (!$category->store()) {
                        echo "<script> alert('".$category->getError()."'); window.history.go(-1); </script>\n";
                        exit();
                }
                $category->checkin();
                // stores original catid
                $newcatids[]["old"] = $id;
                // pulls new catid
                $newcatids[]["new"] = $category->id;
        }

        $content = new mosContent ( $database );
        foreach( $contentid as $id) {
                $content->load( (int)$id );
                $content->id            = NULL;
                $content->sectionid = $sectionMove;
                $content->hits          = 0;
                foreach( $newcatids as $newcatid ) {
                        if ( $content->catid == $newcatid['old'] ) {
                                $content->catid = $newcatid['new'];
                        }
                }
                if (!$content->check()) {
                        echo "<script> alert('".$content->getError()."'); window.history.go(-1); </script>\n";
                        exit();
                }

                if (!$content->store()) {
                        echo "<script> alert('".$content->getError()."'); window.history.go(-1); </script>\n";
                        exit();
                }
                $content->checkin();
        }

        $sectionNew = new mosSection ( $database );
        $sectionNew->load( $sectionMove );

        if ($sectionOld == 'content') {
                // clean any existing cache files
                mosCache::cleanCache( 'com_content' );
        }

        $msg = ( (count($cid) - 1) ? 'Categories' : 'Category' ) .' copied to '. $sectionNew->name;
        mosRedirect( 'index2.php?option=com_categories&section='. $sectionOld .'&mosmsg='. $msg );
}

Hier ist ein Graph der zeigt, was diese Funktion aufruft:

copyCategorySelect	(	$	option,
		$	cid,
		$	sectionOld
	)

Form for copying item(s) to a specific menu

Definiert in Zeile 865 der Datei admin.categories.php.

Benutzt $cid, $database, $items, $option, $query, categories_html::copyCategorySelect(), mosArrayToInts(), mosGetParam() und mosHTML::selectList().

                                                          {
        global $database;

        $redirect = mosGetParam( $_POST, 'section', 'content' );;

        if (!is_array( $cid ) || count( $cid ) < 1) {
                echo "<script> alert('Select an item to move'); window.history.go(-1);</script>\n";
                exit;
        }

        ## query to list selected categories
        mosArrayToInts( $cid );
        $cids = 'a.id=' . implode( ' OR a.id=', $cid );
        $query = "SELECT a.name, a.section"
        . "\n FROM #__categories AS a"
        . "\n WHERE ( $cids )"
        ;
        $database->setQuery( $query );
        $items = $database->loadObjectList();

        ## query to list items from categories
        // mosArrayToInts( $cid ); // Just done a few lines earlier
        $cids = 'a.catid=' . implode( ' OR a.catid=', $cid );
        $query = "SELECT a.title, a.id"
        . "\n FROM #__content AS a"
        . "\n WHERE ( $cids )"
        . "\n ORDER BY a.catid, a.title"
        ;
        $database->setQuery( $query );
        $contents = $database->loadObjectList();

        ## query to choose section to move to
        $query = "SELECT a.name AS `text`, a.id AS `value`"
        . "\n FROM #__sections AS a"
        . "\n WHERE a.published = 1"
        . "\n ORDER BY a.name"
        ;
        $database->setQuery( $query );
        $sections = $database->loadObjectList();

        // build the html select list
        $SectionList = mosHTML::selectList( $sections, 'sectionmove', 'class="inputbox" size="10"', 'value', 'text', null );

        categories_html::copyCategorySelect( $option, $cid, $SectionList, $items, $sectionOld, $contents, $redirect );
}

Hier ist ein Graph der zeigt, was diese Funktion aufruft:

editCategory	(	$	uid = 0,
		$	section = ''
	)

Compiles information to add or edit a category

Parameter:

	string	The name of the category section
	integer	The unique id of the category to edit (0 if new)
	string	The name of the current user

Definiert in Zeile 259 der Datei admin.categories.php.

Benutzt $and, $count, $database, $i, $link, $mainframe, $my, $params, $query, $row, $section, $type, categories_html::edit(), mosHTML::makeOption(), mosGetParam(), mosRedirect(), NULL, recursive_listdir(), mosHTML::selectList() und mosHTML::yesnoRadioList().

                                             {
        global $database, $my, $mainframe;

        $type           = strval( mosGetParam( $_REQUEST, 'type', '' ) );
        $redirect       = strval( mosGetParam( $_REQUEST, 'section', 'content' ) );

        // check for existance of any sections
        $query = "SELECT COUNT( id )"
        . "\n FROM #__sections"
        . "\n WHERE scope = 'content'"
        ;
        $database->setQuery( $query );
        $sections = $database->loadResult();
        if (!$sections && $type != 'other') {
                echo "<script> alert('You need to have at least one Section before you can create a Category'); window.history.go(-1); </script>\n";
                exit();
        }

        $row = new mosCategory( $database );
        // load the row from the db table
        $row->load( (int)$uid );

        // fail if checked out not by 'me'
        if ($row->checked_out && $row->checked_out != $my->id) {
                mosRedirect( 'index2.php?option=categories&section='. $row->section, 'The category '. $row->title .' is currently being edited by another administrator' );
        }

        $lists['links']         = 0;
        $menus                          = NULL;
        $selected_folders       = NULL;
        if ( $uid ) {
                // existing record
                $row->checkout( $my->id );

                // code for Link Menu
                switch ( $row->section ) {
                        case 'com_weblinks':
                                $and    = "\n AND type = 'weblink_category_table'";
                                $link   = 'Table - Weblink Category';
                                break;

                        case 'com_newsfeeds':
                                $and    = "\n AND type = 'newsfeed_category_table'";
                                $link   = 'Table - Newsfeeds Category';
                                break;

                        case 'com_contact_details':
                                $and    = "\n AND type = 'contact_category_table'";
                                $link   = 'Table - Contacts Category';
                                break;

                        default:
                                $and  = '';
                                $link = '';
                                break;
                }

                // content
                if ( $row->section > 0 ) {
                        $query = "SELECT *"
                        . "\n FROM #__menu"
                        . "\n WHERE componentid = " . (int) $row->id
                        . "\n AND ( type = 'content_archive_category' OR type = 'content_blog_category' OR type = 'content_category' )"
                        ;
                        $database->setQuery( $query );
                        $menus = $database->loadObjectList();

                        $count = count( $menus );
                        for( $i = 0; $i < $count; $i++ ) {
                                switch ( $menus[$i]->type ) {
                                        case 'content_category':
                                                $menus[$i]->type = 'Table - Content Category';
                                                break;

                                        case 'content_blog_category':
                                                $menus[$i]->type = 'Blog - Content Category';
                                                break;

                                        case 'content_archive_category':
                                                $menus[$i]->type = 'Blog - Content Category Archive';
                                                break;
                                }
                        }
                        $lists['links'] = 1;

                        // handling for MOSImage directories
                        if ( trim( $row->params ) ) {
                                // get params definitions
                                $params = new mosParameters( $row->params, $mainframe->getPath( 'com_xml', 'com_categories' ), 'component' );
                                $temps  = $params->get( 'imagefolders', '' );

                                $temps  = explode( ',', $temps );
                                foreach( $temps as $temp ) {
                                        $selected_folders[] = mosHTML::makeOption( $temp, $temp );
                                }
                        } else {
                                $selected_folders[] = mosHTML::makeOption( '*2*' );
                        }
                } else {
                        $query = "SELECT *"
                        . "\n FROM #__menu"
                        . "\n WHERE componentid = " . (int) $row->id
                        . $and
                        ;
                        $database->setQuery( $query );
                        $menus = $database->loadObjectList();

                        $count = count( $menus );
                        for( $i = 0; $i < $count; $i++ ) {
                                $menus[$i]->type = $link;
                        }
                        $lists['links'] = 1;
                }
        } else {
                // new record
                $row->section           = $section;
                $row->published         = 1;
                $menus                          = NULL;

                // handling for MOSImage directories
                if ( $row->section == 'content' ) {
                        $selected_folders[]     = mosHTML::makeOption( '*2*' );
                }
        }

        // make order list
        $order = array();
        $query = "SELECT COUNT(*)"
        . "\n FROM #__categories"
        . "\n WHERE section = " . $database->Quote( $row->section )
        ;
        $database->setQuery( $query );
        $max = intval( $database->loadResult() ) + 1;

        for ($i=1; $i < $max; $i++) {
                $order[] = mosHTML::makeOption( $i );
        }

        // build the html select list for sections
        if ( $section == 'content' ) {
                $query = "SELECT s.id AS value, s.title AS text"
                . "\n FROM #__sections AS s"
                . "\n ORDER BY s.ordering"
                ;
                $database->setQuery( $query );
                $sections = $database->loadObjectList();
                $lists['section'] = mosHTML::selectList( $sections, 'section', 'class="inputbox" size="1"', 'value', 'text' );;
        } else {
                if ( $type == 'other' ) {
                        $section_name = 'N/A';
                } else {
                        $temp = new mosSection( $database );
                        $temp->load( $row->section );
                        $section_name = $temp->name;
                }
                $lists['section'] = '<input type="hidden" name="section" value="'. $row->section .'" />'. $section_name;
        }

        // build the html select list for category types
        $types[] = mosHTML::makeOption( '', 'Select Type' );
        if ($row->section == 'com_contact_details') {
                $types[] = mosHTML::makeOption( 'contact_category_table', 'Contact Category Table' );
        } else
        if ($row->section == 'com_newsfeeds') {
                $types[] = mosHTML::makeOption( 'newsfeed_category_table', 'Newsfeed Category Table' );
        } else
        if ($row->section == 'com_weblinks') {
                $types[] = mosHTML::makeOption( 'weblink_category_table', 'Weblink Category Table' );
        } else {
                $types[] = mosHTML::makeOption( 'content_category', 'Content Category Table' );
                $types[] = mosHTML::makeOption( 'content_blog_category', 'Content Category Blog' );
                $types[] = mosHTML::makeOption( 'content_archive_category', 'Content Category Archive Blog' );
        } // if
        $lists['link_type']             = mosHTML::selectList( $types, 'link_type', 'class="inputbox" size="1"', 'value', 'text' );

        // build the html select list for ordering
        $query = "SELECT ordering AS value, title AS text"
        . "\n FROM #__categories"
        . "\n WHERE section = " . $database->Quote( $row->section )
        . "\n ORDER BY ordering"
        ;
        $lists['ordering']                      = stripslashes( mosAdminMenus::SpecificOrdering( $row, $uid, $query ));

        // build the select list for the image positions
        $active =  ( $row->image_position ? $row->image_position : 'left' );
        $lists['image_position']        = mosAdminMenus::Positions( 'image_position', $active, NULL, 0, 0 );
        // Imagelist
        $lists['image']                         = mosAdminMenus::Images( 'image', $row->image );
        // build the html select list for the group access
        $lists['access']                        = mosAdminMenus::Access( $row );
        // build the html radio buttons for published
        $lists['published']             = mosHTML::yesnoRadioList( 'published', 'class="inputbox"', $row->published );
        // build the html select list for menu selection
        $lists['menuselect']            = mosAdminMenus::MenuSelect( );

        // handling for MOSImage directories
        if ( $row->section > 0 || $row->section == 'content' ) {
                // list of folders in images/stories/
                $imgFiles       = recursive_listdir( COM_IMAGE_BASE );
                $len            = strlen( COM_IMAGE_BASE );

                $folders[]      = mosHTML::makeOption( '*2*', 'Use Section settings'  );
                $folders[]      = mosHTML::makeOption( '*#*', '---------------------' );
                $folders[]      = mosHTML::makeOption( '*1*', 'All'  );
                $folders[]      = mosHTML::makeOption( '*0*', 'None' );
                $folders[]      = mosHTML::makeOption( '*#*', '---------------------' );
                $folders[]      = mosHTML::makeOption( '/' );
                foreach ($imgFiles as $file) {
                        $folders[] = mosHTML::makeOption( substr( $file, $len ) );
                }

                $lists['folders'] = mosHTML::selectList( $folders, 'folders[]', 'class="inputbox" size="17" multiple="multiple"', 'value', 'text', $selected_folders );
        }

        categories_html::edit( $row, $lists, $redirect, $menus );
}

Hier ist ein Graph der zeigt, was diese Funktion aufruft:

menuLink

(

$

id

)

Definiert in Zeile 1012 der Datei admin.categories.php.

Benutzt $database, $id, $link, $menu, $menutype, $msg, $name, $row, $sectionid, $type, ampReplace(), mosCache::cleanCache(), josSpoofCheck(), mosGetParam() und mosRedirect().

Wird benutzt von save(), saveCategory(), saveContent() und saveSection().

                         {
        global $database;
        
        josSpoofCheck();

        $category = new mosCategory( $database );
        $category->bind( $_POST );
        $category->checkin();

        $redirect       = strval( mosGetParam( $_POST, 'redirect', '' ) );
        $menu           = stripslashes( strval( mosGetParam( $_POST, 'menuselect', '' ) ) );
        $name           = strval( mosGetParam( $_POST, 'link_name', '' ) );
        $sectionid      = mosGetParam( $_POST, 'sectionid', '' );
        $type           = strval( mosGetParam( $_POST, 'link_type', '' ) );

        $name           = stripslashes( ampReplace($name) );

        switch ( $type ) {
                case 'content_category':
                        $link           = 'index.php?option=com_content&task=category&sectionid='. $sectionid .'&id='. $id;
                        $menutype       = 'Content Category Table';
                        break;

                case 'content_blog_category':
                        $link           = 'index.php?option=com_content&task=blogcategory&id='. $id;
                        $menutype       = 'Content Category Blog';
                        break;

                case 'content_archive_category':
                        $link           = 'index.php?option=com_content&task=archivecategory&id='. $id;
                        $menutype       = 'Content Category Blog Archive';
                        break;

                case 'contact_category_table':
                        $link           = 'index.php?option=com_contact&catid='. $id;
                        $menutype       = 'Contact Category Table';
                        break;

                case 'newsfeed_category_table':
                        $link           = 'index.php?option=com_newsfeeds&catid='. $id;
                        $menutype       = 'Newsfeed Category Table';
                        break;

                case 'weblink_category_table':
                        $link           = 'index.php?option=com_weblinks&catid='. $id;
                        $menutype       = 'Weblink Category Table';
                        break;
        }

        $row                            = new mosMenu( $database );
        $row->menutype          = $menu;
        $row->name                      = $name;
        $row->type                      = $type;
        $row->published         = 1;
        $row->componentid       = $id;
        $row->link                      = $link;
        $row->ordering          = 9999;

        if ( $type == 'content_blog_category' ) {
                $row->params = 'categoryid='. $id;
        }

        if (!$row->check()) {
                echo "<script> alert('".$row->getError()."'); window.history.go(-1); </script>\n";
                exit();
        }
        if (!$row->store()) {
                echo "<script> alert('".$row->getError()."'); window.history.go(-1); </script>\n";
                exit();
        }
        $row->checkin();
        $row->updateOrder( "menutype = " . $database->Quote( $menu ) );

        if ($redirect == 'content') {
                // clean any existing cache files
                mosCache::cleanCache( 'com_content' );
        }

        $msg = $name .' ( '. $menutype .' ) in menu: '. $menu .' successfully created';
        mosRedirect( 'index2.php?option=com_categories&section='. $redirect .'&task=editA&hidemainmenu=1&id='. $id, $msg );
}

Hier ist ein Graph der zeigt, was diese Funktion aufruft:

Hier ist ein Graph der zeigt, wo diese Funktion aufgerufen wird:

moveCategorySave	(	$	cid,
		$	sectionOld
	)

Save the item(s) to the menu selected

Definiert in Zeile 811 der Datei admin.categories.php.

Benutzt $cid, $database, $msg, $query, $total, mosCache::cleanCache(), josSpoofCheck(), mosArrayToInts(), mosGetParam() und mosRedirect().

                                               {
        global $database;
        
        josSpoofCheck();

        if (!is_array( $cid ) || count( $cid ) < 1) {
                echo "<script> alert('Select an item to move'); window.history.go(-1);</script>\n";
                exit;
        }

        $sectionMove    = intval( mosGetParam( $_REQUEST, 'sectionmove', '' ) );
        if ( !$sectionMove ) {
                mosRedirect( 'index.php?option=com_categories&mosmsg=An error has occurred' );
        }

        $total = count( $cid );

        mosArrayToInts( $cid );
        $cids = 'id=' . implode( ' OR id=', $cid );
        $query = "UPDATE #__categories"
        . "\n SET section = " . $sectionMove
        . "\n WHERE ( $cids )"
        ;
        $database->setQuery( $query );
        if ( !$database->query() ) {
                echo "<script> alert('". $database->getErrorMsg() ."'); window.history.go(-1); </script>\n";
                exit();
        }
        // mosArrayToInts( $cid ); // Just done a few lines earlier
        $cids = 'catid=' . implode( ' OR catid=', $cid );
        $query = "UPDATE #__content"
        . "\n SET sectionid = " . $sectionMove
        . "\n WHERE ( $cids )"
        ;
        $database->setQuery( $query );
        if ( !$database->query() ) {
                echo "<script> alert('". $database->getErrorMsg() ."'); window.history.go(-1); </script>\n";
                exit();
        }
        $sectionNew = new mosSection ( $database );
        $sectionNew->load( $sectionMove );

        if ($sectionOld == 'content') {
                // clean any existing cache files
                mosCache::cleanCache( 'com_content' );
        }

        $msg = ( (count($cid) - 1) ? 'Categories' : 'Category' ) .' moved to '. $sectionNew->name;
        mosRedirect( 'index2.php?option=com_categories&section='. $sectionOld .'&mosmsg='. $msg );
}

Hier ist ein Graph der zeigt, was diese Funktion aufruft:

moveCategorySelect	(	$	option,
		$	cid,
		$	sectionOld
	)

Form for moving item(s) to a specific menu

Definiert in Zeile 761 der Datei admin.categories.php.

Benutzt $cid, $database, $items, $option, $query, mosArrayToInts(), mosGetParam(), categories_html::moveCategorySelect() und mosHTML::selectList().

                                                          {
        global $database;

        $redirect = mosGetParam( $_POST, 'section', 'content' );;

        if (!is_array( $cid ) || count( $cid ) < 1) {
                echo "<script> alert('Select an item to move'); window.history.go(-1);</script>\n";
                exit;
        }

        ## query to list selected categories
        mosArrayToInts( $cid );
        $cids = 'a.id=' . implode( ' OR a.id=', $cid );
        $query = "SELECT a.name, a.section"
        . "\n FROM #__categories AS a"
        . "\n WHERE ( $cids )"
        ;
        $database->setQuery( $query );
        $items = $database->loadObjectList();

        ## query to list items from categories
        // mosArrayToInts( $cid ); // Just done a few lines earlier
        $cids = 'a.catid=' . implode( ' OR a.catid=', $cid );
        $query = "SELECT a.title"
        . "\n FROM #__content AS a"
        . "\n WHERE ( $cids )"
        . "\n ORDER BY a.catid, a.title"
        ;
        $database->setQuery( $query );
        $contents = $database->loadObjectList();

        ## query to choose section to move to
        $query = "SELECT a.name AS text, a.id AS value"
        . "\n FROM #__sections AS a"
        . "\n WHERE a.published = 1"
        . "\n ORDER BY a.name"
        ;
        $database->setQuery( $query );
        $sections = $database->loadObjectList();

        // build the html select list
        $SectionList = mosHTML::selectList( $sections, 'sectionmove', 'class="inputbox" size="10"', 'value', 'text', null );

        categories_html::moveCategorySelect( $option, $cid, $SectionList, $items, $sectionOld, $contents, $redirect );
}

Hier ist ein Graph der zeigt, was diese Funktion aufruft:

orderCategory	(	$	uid,
		$	inc
	)

Moves the order of a record

Parameter:

integer

The increment to reorder by

Definiert in Zeile 743 der Datei admin.categories.php.

Benutzt $database, $row, mosCache::cleanCache(), josSpoofCheck() und mosRedirect().

                                     {
        global $database;
        
        josSpoofCheck();

        $row = new mosCategory( $database );
        $row->load( (in