$id = strip_tags($id);
// get the item from the database
$item = Images::get($id);
// get the related anchor, if any
$anchor = NULL;
if (isset($item['anchor'])) {
$anchor = Anchors::get($item['anchor']);
} elseif (isset($_REQUEST['anchor'])) {
$anchor = Anchors::get($_REQUEST['anchor']);
} elseif (isset($context['arguments'][1])) {
$anchor = Anchors::get($context['arguments'][0] . ':' . $context['arguments'][1]);
}
// we are allowed to add a new file
if (!isset($item['id']) && Images::allow_creation($anchor)) {
$permitted = TRUE;
} elseif (isset($item['id']) && Images::allow_modification($anchor, $item)) {
$permitted = TRUE;
} else {
$permitted = FALSE;
}
// do not always show the edition form
$with_form = FALSE;
// load the skin, maybe with a variant
load_skin('images', $anchor);
// clear the tab we are in, if any
if (is_object($anchor)) {
$context['current_focus'] = $anchor->get_focus();
}
// the path to this page
if (is_object($anchor) && $anchor->is_viewable()) {
$context['path_bar'] = $anchor->get_path_bar();
/**
* list images
*
* @param resource the SQL result
* @return string the rendered text
*
* @see layouts/layout.php
**/
function layout($result)
{
global $context;
// we return html text
$text = '';
// empty list
if (!SQL::count($result)) {
return $text;
}
$variant = 'thumbnail';
// process all items in the list
while ($image = SQL::fetch($result)) {
// a title for the image --do not force a title
if (isset($image['title'])) {
$title = $image['title'];
} else {
$title = '';
}
// provide thumbnail if not defined, or forced, or for large images
if (!$image['use_thumbnail'] || $image['use_thumbnail'] == 'A' || $image['use_thumbnail'] == 'Y' && $image['image_size'] > $context['thumbnail_threshold']) {
// where to fetch the image file
$href = Images::get_thumbnail_href($image);
// to drive to plain image
$link = Images::get_icon_href($image);
// add an url, if any
} elseif ($image['link_url']) {
// flag large images
if ($image['image_size'] > $context['thumbnail_threshold']) {
$variant = rtrim('large ' . $variant);
}
// where to fetch the image file
$href = Images::get_icon_href($image);
// transform local references, if any
include_once $context['path_to_root'] . '/links/links.php';
$attributes = Links::transform_reference($image['link_url']);
if ($attributes[0]) {
$link = $context['url_to_root'] . $attributes[0];
} else {
$link = $image['link_url'];
}
// get the <img ... /> element
} else {
// do not append poor titles to inline images
if ($variant == 'thumbnail') {
$title = '';
}
// flag large images
if ($image['image_size'] > $context['thumbnail_threshold']) {
$variant = rtrim('large ' . $variant);
}
// where to fetch the image file
$href = Images::get_icon_href($image);
// no link
$link = '';
}
// use the skin
if (Images::allow_modification($image['anchor'], $image['id'])) {
// build editable image
$text .= Skin::build_image($variant, $href, $title, $link, $image['id']);
} else {
$text .= Skin::build_image($variant, $href, $title, $link);
}
}
// end of processing
SQL::free($result);
return $text;
}
/**
* render a link to an object
*
* Following types are supported:
* - article - link to an article page
* - category - link to a category page
* - comment - link to a comment page
* - download - link to a download page
* - file - link to a file page
* - flash - display a file as a native flash object, or play a flash video
* - go
* - image - display an in-line image
* - next - link to an article page
* - previous - link to an article page
* - section - link to a section page
* - server - link to a server page
* - user - link to a user page
*
* @param string the type
* @param string the id, with possible options or variant
* @return string the rendered text
**/
public static function render_object($type, $id)
{
global $context;
$id = Codes::fix_tags($id);
// depending on type
switch ($type) {
// link to an article
case 'article':
// maybe an alternate title has been provided
$attributes = preg_split("/\\s*,\\s*/", $id, 2);
$id = $attributes[0];
// load the record from the database
if (!($item = Articles::get($id))) {
$output = '[article=' . $id . ']';
} else {
// ensure we have a label for this link
if (isset($attributes[1])) {
$text = $attributes[1];
$type = 'basic';
} else {
$text = Skin::strip($item['title']);
}
// make a link to the target page
$url = Articles::get_permalink($item);
// return a complete anchor
$output =& Skin::build_link($url, $text, $type);
}
return $output;
// insert article description
// insert article description
case 'article.description':
// maybe an alternate title has been provided
$attributes = preg_split("/\\s*,\\s*/", $id, 2);
$id = $attributes[0];
// load the record from the database
if (!($item = Articles::get($id))) {
$output = '[article.description=' . $id . ']';
} else {
// ensure we have a label for this link
if (isset($attributes[1])) {
$text = $attributes[1];
$type = 'basic';
} else {
$text = Skin::strip($item['title']);
}
// make a link to the target page
$url = Articles::get_permalink($item);
// return a complete anchor
$output =& Skin::build_link($url, $text, 'article');
// the introduction text, if any
$output .= BR . Codes::beautify($item['introduction']);
// load overlay, if any
if (isset($item['overlay']) && $item['overlay']) {
$overlay = Overlay::load($item, 'article:' . $item['id']);
// get text related to the overlay, if any
if (is_object($overlay)) {
$output .= $overlay->get_text('view', $item);
}
}
// the description, which is the actual page body
$output .= '<div>' . Codes::beautify($item['description']) . '</div>';
}
return $output;
// link to a category
// link to a category
case 'category':
// maybe an alternate title has been provided
$attributes = preg_split("/\\s*,\\s*/", $id, 2);
$id = $attributes[0];
// load the record from the database
if (!($item = Categories::get($id))) {
$output = '[category=' . $id . ']';
} else {
// ensure we have a label for this link
if (isset($attributes[1])) {
$text = $attributes[1];
$type = 'basic';
} else {
$text = Skin::strip($item['title']);
}
// make a link to the target page
$url = Categories::get_permalink($item);
// return a complete anchor
$output =& Skin::build_link($url, $text, $type);
}
return $output;
// insert category description
// insert category description
case 'category.description':
// maybe an alternate title has been provided
$attributes = preg_split("/\\s*,\\s*/", $id, 2);
$id = $attributes[0];
// load the record from the database
if (!($item = Categories::get($id))) {
$output = '[category.description=' . $id . ']';
} else {
// ensure we have a label for this link
if (isset($attributes[1])) {
$text = $attributes[1];
$type = 'basic';
} else {
$text = Skin::strip($item['title']);
}
// make a link to the target page
$url = Categories::get_permalink($item);
// return a complete anchor
$output =& Skin::build_link($url, $text, 'category');
// the introduction text, if any
$output .= BR . Codes::beautify($item['introduction']);
// load overlay, if any
if (isset($item['overlay']) && $item['overlay']) {
$overlay = Overlay::load($item, 'category:' . $item['id']);
// get text related to the overlay, if any
if (is_object($overlay)) {
$output .= $overlay->get_text('view', $item);
}
}
// the description, which is the actual page body
$output .= '<div>' . Codes::beautify($item['description']) . '</div>';
}
return $output;
// link to a comment
// link to a comment
case 'comment':
include_once $context['path_to_root'] . 'comments/comments.php';
// maybe an alternate title has been provided
$attributes = preg_split("/\\s*,\\s*/", $id, 2);
$id = $attributes[0];
// load the record from the database
if (!($item = Comments::get($id))) {
$output = '[comment=' . $id . ']';
} else {
// ensure we have a label for this link
if (isset($attributes[1])) {
$text = $attributes[1];
} else {
$text = i18n::s('View this comment');
}
// make a link to the target page
$url = $context['url_to_home'] . $context['url_to_root'] . Comments::get_url($item['id']);
// return a complete anchor
$output =& Skin::build_link($url, $text, 'basic');
}
return $output;
// link to a download
// link to a download
case 'download':
// maybe an alternate title has been provided
$attributes = preg_split("/\\s*,\\s*/", $id, 2);
$id = $attributes[0];
// load the record from the database
if (!($item = Files::get($id))) {
// file does not exist anymore
if (isset($attributes[1]) && $attributes[1]) {
$output = $attributes[1] . '<p class="details">' . i18n::s('[this file has been deleted]') . '</p>';
} else {
$output = '[download=' . $id . ']';
}
} else {
// label for this file
$prefix = $text = $suffix = '';
// signal restricted and private files
if ($item['active'] == 'N') {
$prefix .= PRIVATE_FLAG;
} elseif ($item['active'] == 'R') {
$prefix .= RESTRICTED_FLAG;
}
// ensure we have a label for this link
if (isset($attributes[1]) && $attributes[1]) {
$text .= $attributes[1];
// this may describe a previous file, which has been replaced
if ($item['edit_action'] != 'file:create' && $attributes[1] != $item['file_name']) {
$text .= ' <p class="details">' . i18n::s('[this file has been replaced]') . '</p>';
$output = $prefix . $text . $suffix;
return $output;
}
} else {
$text = Skin::strip($item['title'] ? $item['title'] : str_replace('_', ' ', $item['file_name']));
}
// flag files uploaded recently
if ($item['create_date'] >= $context['fresh']) {
$suffix .= NEW_FLAG;
} elseif ($item['edit_date'] >= $context['fresh']) {
$suffix .= UPDATED_FLAG;
}
// always download the file
$url = $context['url_to_home'] . $context['url_to_root'] . Files::get_url($item['id'], 'fetch', $item['file_name']);
// return a complete anchor
$output = $prefix . Skin::build_link($url, $text, 'file') . $suffix;
}
return $output;
// link to a file
// link to a file
case 'file':
// maybe an alternate title has been provided
$attributes = preg_split("/\\s*,\\s*/", $id, 2);
$id = $attributes[0];
// load the record from the database --ensure we get a fresh copy of the record, not a cached one
if (!($item = Files::get($id, TRUE))) {
// file does not exist anymore
if (isset($attributes[1]) && $attributes[1]) {
$output = $attributes[1] . '<p class="details">' . i18n::s('[this file has been deleted]') . '</p>';
} else {
$output = '[file=' . $id . ']';
}
} else {
// maybe we want to illustrate this file
if ($item['edit_action'] != 'file:create' && isset($attributes[1]) && $attributes[1] || !($output = Files::interact($item))) {
// label for this file
$output = $prefix = $text = $suffix = '';
// signal restricted and private files
if ($item['active'] == 'N') {
$prefix .= PRIVATE_FLAG;
} elseif ($item['active'] == 'R') {
$prefix .= RESTRICTED_FLAG;
}
// ensure we have a label for this link
if (isset($attributes[1]) && $attributes[1]) {
$text .= $attributes[1];
// this may describe a previous file, which has been replaced
if ($item['edit_action'] != 'file:create' && $attributes[1] != $item['file_name']) {
$text .= '<p class="details">' . i18n::s('[this file has been replaced]') . '</p>';
$output = $prefix . $text . $suffix;
return $output;
}
} else {
$text .= Skin::strip($item['title'] ? $item['title'] : str_replace('_', ' ', $item['file_name']));
}
// flag files uploaded recently
if ($item['create_date'] >= $context['fresh']) {
$suffix .= NEW_FLAG;
} elseif ($item['edit_date'] >= $context['fresh']) {
$suffix .= UPDATED_FLAG;
}
// make a link to the target page
$url = Files::get_download_url($item);
// return a complete anchor
$output .= $prefix . Skin::build_link($url, $text, 'basic') . $suffix;
}
}
return $output;
// invoke the selector
// invoke the selector
case 'go':
// extract the label, if any
$attributes = preg_split("/\\s*,\\s*/", $id, 2);
$name = $attributes[0];
// ensure we have a label for this link
if (isset($attributes[1])) {
$text = $attributes[1];
} else {
$text = $name;
}
// return a complete anchor
$output = Skin::build_link($context['url_to_home'] . $context['url_to_root'] . normalize_shortcut($name), $text, 'basic');
return $output;
// embed an image
// embed an image
case 'image':
include_once $context['path_to_root'] . 'images/images.php';
// get the variant, if any
$attributes = preg_split("/\\s*,\\s*/", $id, 2);
$id = $attributes[0];
if (isset($attributes[1])) {
$variant = $attributes[1];
} else {
$variant = 'inline';
}
// get the image record
if (!($image = Images::get($id))) {
$output = '[image=' . $id . ']';
return $output;
}
// a title for the image --do not force a title
if (isset($image['title'])) {
$title = $image['title'];
} else {
$title = '';
}
// provide thumbnail if not defined, or forced, or for large images
if (!$image['use_thumbnail'] || $image['use_thumbnail'] == 'A' || $image['use_thumbnail'] == 'Y' && $image['image_size'] > $context['thumbnail_threshold']) {
// not inline anymore, but thumbnail --preserve other variants
if ($variant == 'inline') {
$variant = 'thumbnail';
}
// where to fetch the image file
$href = Images::get_thumbnail_href($image);
// to drive to plain image
$link = Images::get_icon_href($image);
// add an url, if any
} elseif ($image['link_url']) {
// flag large images
if ($image['image_size'] > $context['thumbnail_threshold']) {
$variant = rtrim('large ' . $variant);
}
// where to fetch the image file
$href = Images::get_icon_href($image);
// transform local references, if any
include_once $context['path_to_root'] . '/links/links.php';
$attributes = Links::transform_reference($image['link_url']);
if ($attributes[0]) {
$link = $context['url_to_root'] . $attributes[0];
} else {
$link = $image['link_url'];
}
// get the <img ... /> element
} else {
// do not append poor titles to inline images
if ($variant == 'inline') {
$title = '';
}
// flag large images
if ($image['image_size'] > $context['thumbnail_threshold']) {
$variant = rtrim('large ' . $variant);
}
// where to fetch the image file
$href = Images::get_icon_href($image);
// no link
$link = '';
}
// use the skin
if (Images::allow_modification($image['anchor'], $id)) {
// build editable image
$output =& Skin::build_image($variant, $href, $title, $link, $id);
} else {
$output =& Skin::build_image($variant, $href, $title, $link);
}
return $output;
// embed a stack of images
// embed a stack of images
case 'images':
include_once $context['path_to_root'] . 'images/images.php';
// get the list of ids
$ids = preg_split("/\\s*,\\s*/", $id);
if (!count($ids)) {
$output = '[images=id1, id2, ...]';
return $output;
}
// build the list of images
$items = array();
foreach ($ids as $id) {
// get the image record
if ($image = Images::get($id)) {
// a title for the image --do not force a title
if (isset($image['title'])) {
$title = $image['title'];
} else {
$title = '';
}
// provide thumbnail if not defined, or forced, or for large images
$variant = 'inline';
if (!$image['use_thumbnail'] || $image['use_thumbnail'] == 'A' || $image['use_thumbnail'] == 'Y' && $image['image_size'] > $context['thumbnail_threshold']) {
// not inline anymore, but thumbnail
$variant = 'thumbnail';
// where to fetch the image file
$href = Images::get_thumbnail_href($image);
// to drive to plain image
$link = $context['url_to_root'] . Images::get_url($id);
// add an url, if any
} elseif ($image['link_url']) {
// flag large images
if ($image['image_size'] > $context['thumbnail_threshold']) {
$variant = rtrim('large ' . $variant);
}
// where to fetch the image file
$href = Images::get_icon_href($image);
// transform local references, if any
include_once $context['path_to_root'] . '/links/links.php';
$attributes = Links::transform_reference($image['link_url']);
if ($attributes[0]) {
$link = $context['url_to_root'] . $attributes[0];
} else {
$link = $image['link_url'];
}
// get the <img ... /> element
} else {
// flag large images
if ($image['image_size'] > $context['thumbnail_threshold']) {
$variant = rtrim('large ' . $variant);
}
// where to fetch the image file
$href = Images::get_icon_href($image);
// no link
$link = '';
}
// use the skin
$label =& Skin::build_image($variant, $href, $title, $link);
// add item to the stack
$items[] = $label;
}
}
// format the list
$output = '';
if (count($items)) {
// stack items
$output = Skin::finalize_list($items, 'stack');
// rotate items
$output = Skin::rotate($output);
}
// done
return $output;
// link to the next article
// link to the next article
case 'next':
// maybe an alternate title has been provided
$attributes = preg_split("/\\s*,\\s*/", $id, 2);
$id = $attributes[0];
// load the record from the database
if (!($item = Articles::get($id))) {
$output = '[next=' . $id . ']';
} else {
// ensure we have a label for this link
if (isset($attributes[1])) {
$text = $attributes[1];
} else {
$text = Skin::strip($item['title']);
}
// make a link to the target page
$url = Articles::get_permalink($item);
// return a complete anchor
$output =& Skin::build_link($url, $text, 'next');
}
return $output;
// link to the previous article
// link to the previous article
case 'previous':
// maybe an alternate title has been provided
$attributes = preg_split("/\\s*,\\s*/", $id, 2);
$id = $attributes[0];
// load the record from the database
if (!($item = Articles::get($id))) {
$output = '[previous=' . $id . ']';
} else {
// ensure we have a label for this link
if (isset($attributes[1])) {
$text = $attributes[1];
} else {
$text = Skin::strip($item['title']);
}
// make a link to the target page
$url = Articles::get_permalink($item);
// return a complete anchor
$output =& Skin::build_link($url, $text, 'previous');
}
return $output;
// link to a section
// link to a section
case 'section':
// maybe an alternate title has been provided
$attributes = preg_split("/\\s*,\\s*/", $id, 2);
$id = $attributes[0];
// load the record from the database
if (!($item = Sections::get($id))) {
$output = '[section=' . $id . ']';
} else {
// ensure we have a label for this link
if (isset($attributes[1])) {
$text = $attributes[1];
$type = 'basic';
} else {
$text = Skin::strip($item['title']);
}
// make a link to the target page
$url = Sections::get_permalink($item);
// return a complete anchor
$output =& Skin::build_link($url, $text, $type);
}
return $output;
// link to a server
// link to a server
case 'server':
include_once $context['path_to_root'] . 'servers/servers.php';
// maybe an alternate title has been provided
$attributes = preg_split("/\\s*,\\s*/", $id, 2);
$id = $attributes[0];
// load the record from the database
if (!($item = Servers::get($id))) {
$output = '[server=' . $id . ']';
} else {
// ensure we have a label for this link
if (isset($attributes[1])) {
$text = $attributes[1];
$type = 'basic';
} else {
$text = Skin::strip($item['title']);
}
// make a link to the target page
$url = $context['url_to_home'] . $context['url_to_root'] . Servers::get_url($id);
// return a complete anchor
$output =& Skin::build_link($url, $text, $type);
}
return $output;
// link to a user
// link to a user
case 'user':
// maybe an alternate title has been provided
$attributes = preg_split("/\\s*,\\s*/", $id, 2);
$id = $attributes[0];
// load the record from the database
if (!($item = Users::get($id))) {
$output = '[user='******']';
} else {
// ensure we have a label for this link
if (isset($attributes[1])) {
$text = $attributes[1];
$type = 'basic';
} elseif (isset($item['full_name']) && $item['full_name']) {
$text = ucfirst($item['full_name']);
} else {
$text = ucfirst($item['nick_name']);
}
// make a link to the target page
$url = Users::get_permalink($item);
// return a complete anchor
$output =& Skin::build_link($url, $text, $type);
}
return $output;
// invalid type
// invalid type
default:
$output = '[' . $type . ']';
return $output;
}
}