Add Taxonomies connector, closes #58

connectors/taxonomies.php

@@ -0,0 +1,148 @@
+<?php
+
+class WP_Stream_Connector_Taxonomies extends WP_Stream_Connector {
+
+	/**
+	 * Context name
+	 * @var string
+	 */
+	public static $name = 'taxonomies';
+
+	/**
+	 * Actions registered for this context
+	 * @var array
+	 */
+	public static $actions = array(
+		'created_term',
+		'delete_term',
+		'edit_term',
+		'edited_term',
+	);
+
+	/**
+	 * Cache term values before update, used by callback_edit_term/callback_edited_term
+	 * @var Object
+	 */
+	public static $cached_term_before_update;
+
+	/**
+	 * Cache taxonomy labels
+	 * @var array
+	 */
+	public static $context_labels;
+
+	/**
+	 * Cached taxonomy singular labels, to be used in summaries
+	 * @var array
+	 */
+	public static $singular_labels;
+
+	/**
+	 * Return translated context label
+	 *
+	 * @return string Translated context label
+	 */
+	public static function get_label() {
+		return __( 'Taxonomies', 'stream' );
+	}
+
+	/**
+	 * Return translated action labels
+	 *
+	 * @return array Action label translations
+	 */
+	public static function get_action_labels() {
+		return array(
+			'created' => __( 'Created', 'stream' ),
+			'updated' => __( 'Updated', 'stream' ),
+			'deleted' => __( 'Deleted', 'stream' ),
+		);
+	}
+
+	/**
+	 * Return translated context labels
+	 *
+	 * @return array Context label translations
+	 */
+	public static function get_context_labels() {
+		global $wp_taxonomies;
+		$labels = wp_list_pluck( $wp_taxonomies, 'labels' );
+		self::$context_labels  = wp_list_pluck( $labels, 'name' );
+		self::$singular_labels = array_map( 'strtolower', wp_list_pluck( $labels, 'singular_name' ) );
+		return self::$context_labels;
+	}
+
+	/**
+	 * Add action links to Stream drop row in admin list screen
+	 *
+	 * @filter wp_stream_action_links_{connector}
+	 * @param  array $links      Previous links registered
+	 * @param  int   $record     Stream record
+	 * @return array             Action links
+	 */
+	public static function action_links( $links, $record ) {
+		if ( $record->object_id && $record->action != 'deleted' && ( $term = get_term( $record->object_id, $record->context ) ) ) {
+			$links[ __( 'Edit', 'stream' ) ] = get_edit_term_link( $record->object_id, $record->context );
+			$links[ __( 'View', 'stream' ) ] = get_term_link( get_term( $record->object_id, $record->context ) );
+		}
+		return $links;
+	}
+
+	/**
+	 * Tracks creation of terms
+	 *
+	 * @action created_term
+	 */
+	public static function callback_created_term( $term_id, $tt_id, $taxonomy ) {
+		$term = get_term( $term_id, $taxonomy );
+		$taxonomy_label = self::$singular_labels[$taxonomy];
+		$term_name = $term->name;
+		self::log(
+			__( '"%s" %s created', 'stream' ),
+			compact( 'term_name', 'taxonomy_label', 'term_id', 'taxonomy' ),
+			$term_id,
+			array( $taxonomy => 'created' )
+			);
+	}
+
+	/**
+	 * Tracks deletion of taxonomy terms
+	 *
+	 * @action delete_term
+	 */
+	public static function callback_delete_term( $term_id, $tt_id, $taxonomy, $deleted_term ) {
+		$term_name = $deleted_term->name;
+		$taxonomy_label = self::$singular_labels[$taxonomy];
+		self::log(
+			__( '"%s" %s deleted', 'stream' ),
+			compact( 'term_name', 'taxonomy_label', 'term_id', 'taxonomy' ),
+			$term_id,
+			array( $taxonomy => 'deleted' )
+			);
+	}
+
+	/**
+	 * Tracks updates of taxonomy terms
+	 *
+	 * @action edit_term
+	 */
+	public static function callback_edit_term( $term_id, $tt_id, $taxonomy ) {
+		self::$cached_term_before_update = get_term( $term_id, $taxonomy );
+	}
+
+	public static function callback_edited_term( $term_id, $tt_id, $taxonomy ) {
+		$term = self::$cached_term_before_update;
+		if ( ! $term ) { // for some reason!
+			$term = get_term( $term_id, $taxonomy );
+		}
+		$term_name = $term->name;
+		$taxonomy_label = self::$singular_labels[$taxonomy];
+		self::log(
+			__( '"%s" %s updated', 'stream' ),
+			compact( 'term_name', 'taxonomy_label', 'term_id', 'taxonomy' ),
+			$term_id,
+			array( $taxonomy => 'updated' )
+			);
+	}
+
+}