lorea_production / elgg / engine / lib / admin.php

<?php
/**
 * Elgg admin functions.
 * Functions for adding and manipulating options on the admin panel.
 *
 * @package Elgg
 * @subpackage Core
 */


/**
 * Register an admin page with the admin panel.
 * This function extends the view "admin/main" with the provided view. This view should provide a description
 * and either a control or a link to.
 *
 * Usage:
 * 	- To add a control to the main admin panel then extend admin/main
 *  - To add a control to a new page create a page which renders a view admin/subpage
 *    (where subpage is your new page -
 *    nb. some pages already exist that you can extend), extend the main view to point to it,
 *    and add controls to your new view.
 *
 * At the moment this is essentially a wrapper around elgg_extend_view().
 *
 * @param string $new_admin_view The view associated with the control you're adding
 * @param string $view The view to extend, by default this is 'admin/main'.
 * @param int $priority Optional priority to govern the appearance in the list.
 */
function extend_elgg_admin_page( $new_admin_view, $view = 'admin/main', $priority = 500) {
	return elgg_extend_view($view, $new_admin_view, $priority);
}

/**
 * Initialise the admin page.
 */
function admin_init() {
	// Add plugin main menu option (last)
	extend_elgg_admin_page('admin/main_opt/statistics', 'admin/main');
	extend_elgg_admin_page('admin/main_opt/site', 'admin/main');
	extend_elgg_admin_page('admin/main_opt/user', 'admin/main');
	extend_elgg_admin_page('admin/main_opt/plugins', 'admin/main', 999); // Always last

	register_action('admin/user/ban', false, "", true);
	register_action('admin/user/unban', false, "", true);
	register_action('admin/user/delete', false, "", true);
	register_action('admin/user/spammer', false, "", true);
	register_action('admin/user/resetpassword', false, "", true);
	register_action('admin/user/makeadmin', false, "", true);
	register_action('admin/user/removeadmin', false, "", true);

	// Register some actions
	register_action('admin/site/update_basic', false, "", true); // Register basic site admin action

	// Page handler
	register_page_handler('admin','admin_settings_page_handler');

//	if (isadminloggedin()) {
//		global $is_admin;
//		$is_admin = true;
//	}
}

/**
 * Add submenu items for admin page.
 */
function admin_pagesetup() {
	if (get_context() == 'admin') {
		global $CONFIG;

		add_submenu_item(elgg_echo('admin:statistics'), $CONFIG->wwwroot . 'pg/admin/statistics/');
		add_submenu_item(elgg_echo('admin:site'), $CONFIG->wwwroot . 'pg/admin/site/');
		add_submenu_item(elgg_echo('admin:user'), $CONFIG->wwwroot . 'pg/admin/user/');
		add_submenu_item(elgg_echo('admin:plugins'), $CONFIG->wwwroot . 'pg/admin/plugins/');
	}
}

/**
 * Handle admin pages.
 *
 * @todo this should probably return something to prevent the default page handler from running
 * @param $page
 * @return unknown_type
 */
function admin_settings_page_handler($page) {
	global $CONFIG;

	$path = $CONFIG->path . "admin/index.php";

	if ($page[0]) {
		switch ($page[0]) {
			case 'user':
				$path = $CONFIG->path . "admin/user.php";
				break;
			case 'statistics':
				$path = $CONFIG->path . "admin/statistics.php";
				break;
			case 'plugins':
				$path = $CONFIG->path . "admin/plugins.php";
				break;
			case 'site':
				$path = $CONFIG->path . "admin/site.php";
				break;
		}
	}

	if ($page[1]) {
		set_input('username', $page[1]);
	}

	include($path);
}

/**
 * Write a persistent message to the administrator's notification window.
 *
 * Currently this writes a message to the admin store, we may want to come up with another way at some point.
 *
 * @param string $subject Subject of the message
 * @param string $message Body of the message
 */
function send_admin_message($subject, $message) {
	$subject = sanitise_string($subject);
	$message = sanitise_string($message);

	if (($subject) && ($message)) {
		$admin_message = new ElggObject();
		$admin_message->subtype = 'admin_message';
		$admin_message->access_id = ACCESS_PUBLIC;
		$admin_message->title = $subject;
		$admin_message->description = $message;

		return $admin_message->save();
	}

	return false;
}

/**
 * List all admin messages.
 *
 * @param int $limit Limit
 */
function list_admin_messages($limit = 10) {
	return elgg_list_entities(array(
		'type' => 'object', 
		'subtype' => 'admin_message', 
		'limit' => $limit
	));
}

/**
 * Remove an admin message.
 *
 * @param int $guid The
 */
function clear_admin_message($guid) {
	return delete_entity($guid);
}

/// Register init functions
register_elgg_event_handler('init', 'system', 'admin_init');
register_elgg_event_handler('pagesetup', 'system', 'admin_pagesetup');
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.