<?php
+/**
+ * Recent changes tagging.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ * http://www.gnu.org/copyleft/gpl.html
+ *
+ * @file
+ */
class ChangeTags {
+
+ /**
+ * Creates HTML for the given tags
+ *
+ * @param $tags String: Comma-separated list of tags
+ * @param $page String: A label for the type of action which is being displayed,
+ * for example: 'history', 'contributions' or 'newpages'
+ *
+ * @return Array with two items: (html, classes)
+ * - html: String: HTML for displaying the tags (empty string when param $tags is empty)
+ * - classes: Array of strings: CSS classes used in the generated html, one class for each tag
+ *
+ */
static function formatSummaryRow( $tags, $page ) {
if( !$tags )
return array( '', array() );
);
$classes[] = Sanitizer::escapeClass( "mw-tag-$tag" );
}
-
$markers = '(' . implode( ', ', $displayTags ) . ')';
$markers = Xml::tags( 'span', array( 'class' => 'mw-tag-markers' ), $markers );
+
return array( $markers, $classes );
}
+ /**
+ * Get a short description for a tag
+ *
+ * @param $tag String: tag
+ *
+ * @return String: Short description of the tag from "mediawiki:tag-$tag" if this message exists,
+ * html-escaped version of $tag otherwise
+ */
static function tagDescription( $tag ) {
$msg = wfMessage( "tag-$tag" );
return $msg->exists() ? $msg->parse() : htmlspecialchars( $tag );
}
- ## Basic utility method to add tags to a particular change, given its rc_id, rev_id and/or log_id.
+ /**
+ * Add tags to a change given its rc_id, rev_id and/or log_id
+ *
+ * @param $tags String|Array: Tags to add to the change
+ * @param $rc_id int: rc_id of the change to add the tags to
+ * @param $rev_id int: rev_id of the change to add the tags to
+ * @param $log_id int: log_id of the change to add the tags to
+ * @param $params String: params to put in the ct_params field of tabel 'change_tag'
+ *
+ * @return bool: false if no changes are made, otherwise true
+ *
+ * @exception MWException when $rc_id, $rev_id and $log_id are all null
+ */
static function addTags( $tags, $rc_id = null, $rev_id = null, $log_id = null, $params = null ) {
if ( !is_array( $tags ) ) {
$tags = array( $tags );
* Applies all tags-related changes to a query.
* Handles selecting tags, and filtering.
* Needs $tables to be set up properly, so we can figure out which join conditions to use.
+ *
+ * @param $tables String|Array: Tabel names, see DatabaseBase::select
+ * @param $fields String|Array: Fields used in query, see DatabaseBase::select
+ * @param $conds String|Array: conditions used in query, see DatabaseBase::select
+ * @param $join_conds Array: join conditions, see DatabaseBase::select
+ * @param $options Array: options, see Database::select
+ * @param $filter_tag String: tag to select on
+ *
+ * @exception MWException when unable to determine appropriate JOIN condition for tagging
+ *
*/
static function modifyDisplayQuery( &$tables, &$fields, &$conds,
&$join_conds, &$options, $filter_tag = false ) {
global $wgRequest, $wgUseTagFilter;
if( $filter_tag === false ) {
- $filter_tag = $wgRequest->getVal( 'tagfilterdropdown', '' );
- if ( $filter_tag === '' || $filter_tag === 'other' ) {
- $filter_tag = $wgRequest->getVal( 'tagfilter' );
- }
+ $filter_tag = $wgRequest->getVal( 'tagfilter' );
}
// Figure out which conditions can be done.
return $fullForm ? '' : array();
$data = array( Html::rawElement( 'label', array( 'for' => 'tagfilter' ), wfMsgExt( 'tag-filter', 'parseinline' ) ),
- Xml::input( 'tagfilter', 20, $selected ) );
+ Xml::input( 'tagfilter', 20, $selected, array( 'class' => 'mw-tagfilter-input' ) ) );
if ( !$fullForm ) {
return $data;
$html = implode( ' ', $data );
$html .= "\n" . Xml::element( 'input', array( 'type' => 'submit', 'value' => wfMsg( 'tag-filter-submit' ) ) );
$html .= "\n" . Html::hidden( 'title', $title->getPrefixedText() );
- $html = Xml::tags( 'form', array( 'action' => $title->getLocalURL(), 'method' => 'get' ), $html );
+ $html = Xml::tags( 'form', array( 'action' => $title->getLocalURL(), 'class' => 'mw-tagfilter-form', 'method' => 'get' ), $html );
return $html;
}
/**
- * Build a text box and a dropdown list to select a change tag
+ * Basically lists defined tags which count even if they aren't applied to anything.
+ * Tags on items in table 'change_tag' which are not (or no longer) in table 'valid_tag'
+ * are not included.
*
- * @param $msgkey String: message key for the message where a (newline delimited)
- * list of tags can be specified. These tags will be put in the dropdown list.
- * If the specified message is empty, only the text field will be returned.
- * @param $selectedtxt String: tag to put in text box
- * @param $selecteddropdown String: tag to select in dropdown
- * @return Array of html fragments of which the first element is the label
- * If $wgUseTagFilter is false or there are no defined tags, an empty array is returned
- */
- public static function buildTagFilterWithDropdown( $msgkey, $selectedtxt = '', $selecteddropdown = 'other' ) {
-
- global $wgUseTagFilter;
-
- $definedtags = self::listDefinedTags();
-
- if ( !$wgUseTagFilter || !count( $definedtags ) ) {
- // no tag filter if there are no tags defined or $wgUseTagFilter is false
- return array();
- }
-
- // Extract tags from message: one tag per line
- $tags = preg_split( "/\n/", wfMsgForContent( $msgkey ), -1, PREG_SPLIT_NO_EMPTY);
-
- $data[] = Html::rawElement( 'label', array( 'for' => 'tagfilter' ), wfMsgExt( 'tag-filter', 'parseinline' ) );
-
- if ( count( $tags ) ) {
- // Add dropdown list only when message $msgkey contains at least one tag
- $data[] = Xml::listDropDown( 'tagfilterdropdown', implode( "\n", $tags ),
- wfMsgForContent( 'tag-filter-dropdown-other' ), $selecteddropdown );
- }
-
- $data[] = Xml::input( 'tagfilter', 20, $selectedtxt );
-
- return $data;
-
- }
-
- /**
- *Basically lists defined tags which count even if they aren't applied to anything
+ * Tries memcached first.
*
- * @return array
+ * @return Array of strings: tags
*/
static function listDefinedTags() {
// Caching...