<?php
/**
 * Plain words for events, as shown on the Activity screen and in reports.
 *
 * @package Monthwrap
 */

defined( 'ABSPATH' ) || exit;

/**
 * Describes events for people.
 */
class Monthwrap_Log {

	/**
	 * One line describing an event.
	 *
	 * @param array $event The event.
	 * @param bool  $lead_names Whether a lead's name may be shown (reports can leave it out).
	 * @return string
	 */
	public static function describe( array $event, $lead_names = true ) {
		$title = (string) ( $event['title'] ?? '' );
		$name  = (string) ( $event['name'] ?? '' );
		$from  = (string) ( $event['from_version'] ?? '' );
		$to    = (string) ( $event['to_version'] ?? '' );

		switch ( $event['type'] ?? '' ) {
			case 'post_published':
				if ( 'page' === ( $event['post_type'] ?? '' ) ) {
					/* translators: %s: page title. */
					return sprintf( __( 'Published the page "%s"', 'monthwrap' ), $title );
				}
				if ( 'product' === ( $event['post_type'] ?? '' ) ) {
					/* translators: %s: product name. */
					return sprintf( __( 'Added the product "%s"', 'monthwrap' ), $title );
				}
				/* translators: %s: post title. */
				return sprintf( __( 'Published "%s"', 'monthwrap' ), $title );
			case 'page_updated':
			case 'post_updated':
				/* translators: %s: post or page title. */
				return sprintf( __( 'Updated "%s"', 'monthwrap' ), $title );
			case 'plugin_updated':
				/* translators: 1: plugin name, 2: old version, 3: new version. */
				return sprintf( __( 'Updated the %1$s plugin from %2$s to %3$s', 'monthwrap' ), $name, $from, $to );
			case 'theme_updated':
				/* translators: 1: theme name, 2: old version, 3: new version. */
				return sprintf( __( 'Updated the %1$s theme from %2$s to %3$s', 'monthwrap' ), $name, $from, $to );
			case 'core_updated':
				/* translators: 1: old WordPress version, 2: new version. */
				return sprintf( __( 'Updated WordPress from %1$s to %2$s', 'monthwrap' ), $from, $to );
			case 'server_updated':
				/* translators: 1: server software (PHP, MySQL or MariaDB), 2: old version, 3: new version. */
				return sprintf( __( 'The server\'s %1$s was updated from %2$s to %3$s', 'monthwrap' ), $name, $from, $to );
			case 'plugin_installed':
				/* translators: %s: plugin name. */
				return sprintf( __( 'Installed the %s plugin', 'monthwrap' ), $name );
			case 'plugin_removed':
				/* translators: %s: plugin name. */
				return sprintf( __( 'Removed the %s plugin', 'monthwrap' ), $name );
			case 'theme_installed':
				/* translators: %s: theme name. */
				return sprintf( __( 'Installed the %s theme', 'monthwrap' ), $name );
			case 'theme_removed':
				/* translators: %s: theme name. */
				return sprintf( __( 'Removed the %s theme', 'monthwrap' ), $name );
			case 'backup_completed':
				if ( 'failed' === ( $event['status'] ?? '' ) ) {
					/* translators: %s: backup plugin name. */
					return sprintf( __( 'A backup with %s failed', 'monthwrap' ), $name );
				}
				/* translators: %s: backup plugin name. */
				return sprintf( __( 'Backed up the site with %s', 'monthwrap' ), $name );
			case 'template_updated':
				/* translators: %s: template name, e.g. Header. */
				return sprintf( __( 'Edited the "%s" template', 'monthwrap' ), $name );
			case 'menu_updated':
				/* translators: %s: menu name. */
				return sprintf( __( 'Updated the "%s" menu', 'monthwrap' ), $name );
			case 'design_updated':
				return __( 'Changed the site\'s design settings', 'monthwrap' );
			case 'form_submitted':
				$form = '' !== (string) ( $event['form_name'] ?? '' ) ? (string) $event['form_name'] : __( 'a form', 'monthwrap' );
				$who  = (string) ( $event['name'] ?? $event['email'] ?? $event['phone'] ?? '' );
				if ( ! $lead_names || '' === $who ) {
					/* translators: %s: form name. */
					return sprintf( __( 'New lead through %s', 'monthwrap' ), $form );
				}
				/* translators: 1: the person's name or email, 2: form name. */
				return sprintf( __( 'New lead from %1$s, through %2$s', 'monthwrap' ), $who, $form );
		}
		return (string) ( $event['type'] ?? '' );
	}

	/**
	 * Which group an event belongs to, for filters and report sections.
	 *
	 * @param string $type Event type.
	 * @return string content, maintenance, backups, site or leads.
	 */
	public static function group( $type ) {
		foreach ( Monthwrap_Report::SECTIONS as $group => $types ) {
			if ( in_array( $type, $types, true ) ) {
				return $group;
			}
		}
		return 'maintenance';
	}

	/**
	 * The groups' names, for people.
	 *
	 * @return array<string, string>
	 */
	public static function groups() {
		return array(
			'content'     => __( 'Content', 'monthwrap' ),
			'maintenance' => __( 'Maintenance', 'monthwrap' ),
			'backups'     => __( 'Backups', 'monthwrap' ),
			'site'        => __( 'Design', 'monthwrap' ),
			'leads'       => __( 'Leads', 'monthwrap' ),
		);
	}

	/**
	 * What one event of each group is called, for lists: "Backup", "Lead".
	 *
	 * @return array<string, string>
	 */
	public static function kinds() {
		return array(
			'content'     => __( 'Content', 'monthwrap' ),
			'maintenance' => __( 'Maintenance', 'monthwrap' ),
			'backups'     => __( 'Backup', 'monthwrap' ),
			'site'        => __( 'Design', 'monthwrap' ),
			'leads'       => __( 'Lead', 'monthwrap' ),
		);
	}
}