class.llms.certificate.php

<?php
/**
 * Base Certificate Class
 *
 * Handles generating certificates.
 *
 * @package LifterLMS/Classes
 *
 * @since 1.0.0
 * @version 4.0.0
 */

defined( 'ABSPATH' ) || exit;

/**
 * Base Certificate Class
 *
 * @since 1.0.0
 * @since 3.30.3 Explicitly define class properties.
 * @since 4.0.0 Remove previously deprecated class property `$enabled`.
 */
class LLMS_Certificate {

	/**
	 * @var int
	 * @since 1.0.0
	 */
	public $certificate_template_id;

	/**
	 * post title
	 *
	 * @var string
	 * @since 1.0.0
	 */
	public $certificate_title;

	/**
	 * @var string
	 * @since 1.0.0
	 */
	public $content;

	/**
	 * @var string
	 * @since 1.0.0
	 */
	public $email_type;

	/**
	 * @var array
	 * @since 1.0.0
	 */
	public $find = array();

	/**
	 * @var string
	 * @since 1.0.0
	 */
	public $id;

	/**
	 * image id
	 *
	 * @var int
	 * @since 1.0.0
	 */
	public $image;

	/**
	 * @var int
	 * @since 1.0.0
	 */
	public $lesson_id;

	/**
	 * @var WP_User
	 * @since 1.0.0
	 */
	public $object;

	/**
	 * @var array
	 * @since 1.0.0
	 */
	public $replace = array();

	/**
	 * @var bool
	 * @since 1.0.0
	 */
	public $sending;

	/**
	 * post title
	 *
	 * @var string
	 * @since 1.0.0
	 */
	public $title;

	/**
	 * @var int
	 * @since 1.0.0
	 */
	public $userid;

	/**
	 * Constructor
	 */
	public function __construct() {

		// Settings TODO Refactor: theses can come from the email post now.
		$this->email_type = 'html';

		$this->find    = array( '{blogname}', '{site_title}' );
		$this->replace = array( $this->get_blogname(), $this->get_blogname() );

	}

	/**
	 * Is Enabled
	 *
	 * @return boolean
	 */
	public function is_enabled() {
		return true;
	}

	/**
	 * Get Blog Name
	 *
	 * @return string [blog name]
	 */
	public function get_blogname() {
		return wp_specialchars_decode( get_option( 'blogname' ), ENT_QUOTES );
	}

	/**
	 * Format String
	 *
	 * @param  string $string [Find and replace merge fields]
	 * @return string [formatted string]
	 */
	public function format_string( $string ) {
		return str_replace( $this->find, $this->replace, $string );
	}

	/**
	 * Get Blog Title
	 *
	 * @return string [Blog title]
	 */
	public function get_title() {
		return apply_filters( '_llms_certificate_title' . $this->id, $this->title, $this->object );
	}

	/**
	 * Get Content
	 *
	 * @return string [Post Content]
	 */
	public function get_content() {

		$this->sending = true;

		$email_content = $this->get_content_html();

		return $email_content;
	}

	/**
	 * Get Content HTML
	 *
	 * @return void
	 */
	public function get_content_html() {}

	/**
	 * Create Certificate
	 *
	 * @param    string $content [html formatted post content]
	 * @return   void
	 * @since    1.0.0
	 * @version  3.8.0
	 */
	public function create( $content ) {
		global $wpdb;

		$new_user_certificate = apply_filters(
			'lifterlms_new_page',
			array(
				'post_type'    => 'llms_my_certificate',
				'post_title'   => $this->title,
				'post_content' => $content,
				'post_status'  => 'publish',
				'post_author'  => 1,
			)
		);

		$new_user_certificate_id = wp_insert_post( $new_user_certificate, true );

		update_post_meta( $new_user_certificate_id, '_llms_certificate_title', $this->certificate_title );
		update_post_meta( $new_user_certificate_id, '_llms_certificate_image', $this->image );
		update_post_meta( $new_user_certificate_id, '_llms_certificate_template', $this->certificate_template_id );

		$user_metadatas = array(
			'_certificate_earned' => $new_user_certificate_id,
		);

		foreach ( $user_metadatas as $key => $value ) {
			$update_user_postmeta = $wpdb->insert(
				$wpdb->prefix . 'lifterlms_user_postmeta',
				array(
					'user_id'      => $this->userid,
					'post_id'      => $this->lesson_id,
					'meta_key'     => $key,
					'meta_value'   => $value,
					'updated_date' => current_time( 'mysql' ),
				)
			);
		}

		/**
		 * Allow 3rd parties to hook into the generation of an achievement
		 * Notifications uses this
		 * note 3rd param $this->lesson_id is actually the related post id (but misnamed)
		 */
		do_action( 'llms_user_earned_certificate', $this->userid, $new_user_certificate_id, $this->lesson_id );

	}

}