<?php
namespace WordPressDotOrg\FiveForTheFuture\PledgeLog;

use WordPressDotOrg\FiveForTheFuture;
use WordPressDotOrg\FiveForTheFuture\{ Contributor, Pledge, PledgeForm, PledgeMeta };
use WP_Post;

defined( 'WPINC' ) || die();

const LOG_META_KEY = FiveForTheFuture\PREFIX . '_activity-log';

// Log display.
add_action( 'admin_init', __NAMESPACE__ . '\add_log_meta_box' );

// Log capture.
add_action( 'save_post_' . Pledge\CPT_ID, __NAMESPACE__ . '\capture_save_post', 99, 3 );
add_action( 'updated_postmeta', __NAMESPACE__ . '\capture_updated_postmeta', 99, 4 );
add_action( 'added_post_meta', __NAMESPACE__ . '\capture_added_post_meta', 99, 4 );
add_action( 'deleted_post_meta', __NAMESPACE__ . '\capture_deleted_post_meta', 99, 4 );
add_action( 'transition_post_status', __NAMESPACE__ . '\capture_transition_post_status', 99, 3 );
add_action( FiveForTheFuture\PREFIX . '_add_pledge_contributors', __NAMESPACE__ . '\capture_add_pledge_contributors', 99, 3 );
add_action( FiveForTheFuture\PREFIX . '_remove_contributor', __NAMESPACE__ . '\capture_remove_contributor', 99, 3 );
add_action( FiveForTheFuture\PREFIX . '_email_result', __NAMESPACE__ . '\capture_email_result', 99, 6 );

/**
 * Adds a meta box for the log on the custom post type.
 *
 * @return void
 */
function add_log_meta_box() {
	add_meta_box(
		'activity-log',
		__( 'Log', 'wporg-5ftf' ),
		__NAMESPACE__ . '\render_log_meta_box',
		Pledge\CPT_ID,
		'advanced',
		'low'
	);
}

/**
 * Output the log in the meta box.
 *
 * @param WP_Post $pledge
 *
 * @return void
 */
function render_log_meta_box( $pledge ) {
	$log = get_pledge_log( $pledge->ID );

	require FiveForTheFuture\get_views_path() . 'log.php';
}

/**
 * Defaults for a log entry.
 *
 * @return array {
 *     @type int    $timestamp Time of the event.
 *     @type string $type      The type of event. A snake_case or kebab-case string.
 *     @type string $message   Description of the event.
 *     @type array  $data      Details and data related to the event.
 *     @type int    $user_id   The ID of the logged in user who triggered the event, if applicable.
 * }
 */
function get_log_entry_template() {
	return array(
		'timestamp' => time(),
		'type'      => '',
		'message'   => '',
		'data'      => array(),
		'user_id'   => get_current_user_id(),
	);
}

/**
 * Get a time-sorted array of log entries for a particular pledge.
 *
 * @param int $pledge_id
 *
 * @return array
 */
function get_pledge_log( $pledge_id ) {
	$log = get_post_meta( $pledge_id, LOG_META_KEY, false );

	if ( ! $log ) {
		return array();
	}

	usort( $log, function( $a, $b ) {
		if ( $a['timestamp'] === $b['timestamp'] ) {
			return 0;
		}

		return ( $a['timestamp'] < $b['timestamp'] ) ? -1 : 1;
	} );

	return $log;
}

/**
 * Add a new log entry for a particular pledge.
 *
 * @param int    $pledge_id
 * @param string $type
 * @param string $message
 * @param array  $data
 * @param int    $user_id
 *
 * @return void
 */
function add_log_entry( $pledge_id, $type, $message, array $data = array(), $user_id = 0 ) {
	$entry = get_log_entry_template();

	$entry['type']    = $type;
	$entry['message'] = $message;
	$entry['data']    = $data;

	if ( $user_id ) {
		// The template defaults to the current user, so this function parameter shouldn't override unless it's different.
		$entry['user_id'] = $user_id;

	} elseif ( 'cli' === php_sapi_name() ) {
		/*
		 * `wp_shell`, etc can only be run from w.org sandboxes, and the hostname is the best way to identify
		 * which sandbox was used.
		 */
		$entry['user_id'] = gethostname();
	}

	add_post_meta( $pledge_id, LOG_META_KEY, $entry, false );
}

/**
 * Record logs for events when saving a post.
 *
 * Hooked to "save_post_{$post->post_type}".
 *
 * @param int     $post_ID Post ID.
 * @param WP_Post $post    Unused. Post object.
 * @param bool    $update  Whether this is an existing post being updated or not.
 *
 * @return void
 */
function capture_save_post( $post_ID, $post, $update ) {
	if ( false === $update ) {
		add_log_entry(
			$post_ID,
			'pledge_created',
			sprintf(
				'Pledge created. Status set to <code>%s</code>.',
				esc_html( get_post_status( $post_ID ) )
			),
			PledgeForm\get_form_submission()
		);
	}
}

/**
 * Record logs for events when postmeta values change.
 *
 * @param int    $meta_id    Unused. ID of updated metadata entry.
 * @param int    $object_id  Post ID.
 * @param string $meta_key   Meta key.
 * @param mixed  $meta_value Meta value.
 *
 * @return void
 */
function capture_updated_postmeta( $meta_id, $object_id, $meta_key, $meta_value ) {
	$post_type = get_post_type( $object_id );

	if ( Pledge\CPT_ID !== $post_type ) {
		return;
	}

	$valid_keys       = array_keys( PledgeMeta\get_pledge_meta_config( 'user_input' ) );
	$trimmed_meta_key = str_replace( PledgeMeta\META_PREFIX, '', $meta_key );

	if ( in_array( $trimmed_meta_key, $valid_keys, true ) ) {
		add_log_entry(
			$object_id,
			'pledge_data_changed',
			sprintf(
				'Changed <code>%1$s</code> to <code>%2$s</code>.',
				esc_html( $trimmed_meta_key ),
				esc_html( $meta_value )
			),
			array(
				$meta_key => $meta_value,
			)
		);
	} elseif ( '_thumbnail_id' === $meta_key ) {
		add_log_entry(
			$object_id,
			'pledge_logo_changed',
			sprintf(
				'Changed logo to <code>%s</code>.',
				get_the_post_thumbnail_url( $object_id, 'pledge-logo' )
			)
		);
	}
}

/**
 * Record logs for events when postmeta is deleted.
 *
 * @param array  $meta_ids   An array of deleted metadata entry IDs.
 * @param int    $object_id  Post ID.
 * @param string $meta_key   Meta key.
 * @param mixed  $meta_value Meta value.
 *
 * @return void
 */
function capture_deleted_post_meta( $meta_ids, $object_id, $meta_key, $meta_value ) {
	$post_type = get_post_type( $object_id );

	if ( Pledge\CPT_ID !== $post_type ) {
		return;
	}

	if ( '_thumbnail_id' === $meta_key ) {
		add_log_entry(
			$object_id,
			'pledge_logo_removed',
			'Removed logo from pledge.'
		);
	}
}


/**
 * Record logs for events when new postmeta values are added (not changed).
 *
 * @param int    $meta_id    Unused. ID of updated metadata entry.
 * @param int    $object_id  Post ID.
 * @param string $meta_key   Meta key.
 * @param mixed  $meta_value Meta value.
 *
 * @return void
 */
function capture_added_post_meta( $meta_id, $object_id, $meta_key, $meta_value ) {
	$post_type = get_post_type( $object_id );

	if ( Pledge\CPT_ID !== $post_type ) {
		return;
	}

	switch ( $meta_key ) {
		case PledgeMeta\META_PREFIX . 'pledge-email-confirmed':
			if ( true === $meta_value ) {
				add_log_entry(
					$object_id,
					'pledge_email_confirmed',
					'Pledge email address confirmed.',
					array(
						'email' => get_post_meta( $object_id, PledgeMeta\META_PREFIX . 'org-pledge-email', true ),
					)
				);
			}
			break;
	}
}

/**
 * Record logs for events when a pledge post's status changes.
 *
 * @param string  $new_status
 * @param string  $old_status
 * @param WP_Post $post
 *
 * @return void
 */
function capture_transition_post_status( $new_status, $old_status, WP_Post $post ) {
	$cpts      = array( Pledge\CPT_ID, Contributor\CPT_ID );
	$post_type = get_post_type( $post );

	if ( ! in_array( $post_type, $cpts, true ) ) {
		return;
	}

	if ( $new_status === $old_status ) {
		return;
	}

	switch ( $post_type ) {
		case Pledge\CPT_ID:
			add_log_entry(
				$post->ID,
				'pledge_status_changed',
				sprintf(
					'Pledge status changed from <code>%1$s</code> to <code>%2$s</code>.',
					esc_html( $old_status ),
					esc_html( $new_status )
				),
				array()
			);
			break;

		case Contributor\CPT_ID:
			$pledge = get_post( $post->post_parent );

			add_log_entry(
				$pledge->ID,
				'contributor_status_changed',
				sprintf(
					'Contributor <code>%1$s</code> status changed from <code>%2$s</code> to <code>%3$s</code>.',
					esc_html( $post->post_title ),
					esc_html( $old_status ),
					esc_html( $new_status )
				),
				array()
			);
			break;
	}
}

/**
 * Record a log for the event of contributors being added to a pledge.
 *
 * @param int   $pledge_id    The post ID of the pledge.
 * @param array $contributors Array of contributor wporg usernames.
 * @param array $results      Associative array, key is wporg username, value is post ID on success,
 *                            or an error code on failure.
 *
 * @return void
 */
function capture_add_pledge_contributors( $pledge_id, $contributors, $results ) {
	add_log_entry(
		$pledge_id,
		'contributors_added',
		sprintf(
			'Contributors added: <code>%s</code>',
			implode( '</code>, <code>', $contributors )
		),
		$results
	);
}

/**
 * Record a log for the event when a contributor is removed from a pledge.
 *
 * @param int                $pledge_id           The post ID of the pledge.
 * @param int                $contributor_post_id The post ID of the pledge.
 * @param WP_Post|false|null $result              The result of the attempt to trash the post.
 *
 * @return void
 */
function capture_remove_contributor( $pledge_id, $contributor_post_id, $result ) {
	// If the result isn't a post object, then it was already trashed, or didn't exist.
	if ( $result instanceof WP_Post ) {
		$contributor_post = get_post( $contributor_post_id );

		add_log_entry(
			$pledge_id,
			'contributor_removed',
			sprintf(
				'Contributor removed: <code>%s</code>',
				esc_html( $contributor_post->post_title )
			),
			array(
				'previous_status' => $contributor_post->_wp_trash_meta_status,
			)
		);
	}
}

/**
 * Capture the results of an attempt to send an email.
 *
 * @param string $to
 * @param string $subject
 * @param string $message
 * @param array  $headers
 * @param bool   $result
 * @param int    $pledge_id
 */
function capture_email_result( $to, $subject, $message, $headers, $result, $pledge_id ) {
	add_log_entry(
		$pledge_id,
		'send_email_result',
		sprintf(
			'Sending email to %s %s.',
			$to,
			$result ? 'succeeded' : 'failed'
		),
		compact( 'to', 'subject', 'message', 'headers', 'result' )
	);
}