Pronamic\WordPress\Pay\Subscriptions\Subscription

Complexity

Total Complexity

59

Size/Duplication

Total Lines	823
Duplicated Lines	0 %

Importance

Changes

0

42 Methods

Rating	Name	Duplication	Size	Complexity
A	get_interval_period()	0	2	1
A	set_meta()	0	12	3
A	get_status()	0	2	1
A	get_date_interval()	0	6	1
A	get_meta()	0	4	1
A	set_consumer_name()	0	2	1
A	get_transaction_id()	0	2	1
A	get_amount()	0	2	1
A	get_description()	0	2	1
A	set_transaction_id()	0	2	1
A	get_interval()	0	2	1
A	get_source()	0	2	1
A	get_source_description()	0	11	2
A	__construct()	0	9	2
A	set_status()	0	2	1
A	get_source_link()	0	11	2
A	get_frequency()	0	2	1
A	get_payments()	0	2	1
A	get_currency()	0	2	1
A	get_id()	0	2	1
A	set_consumer_iban()	0	2	1
A	get_source_id()	0	2	1
A	get_cancel_url()	0	10	1
A	set_consumer_bic()	0	2	1
A	get_renewal_url()	0	10	1
A	set_id()	0	2	1
A	add_note()	0	16	1
A	get_key()	0	2	1
A	get_expiry_date()	0	2	1
B	update_meta()	0	26	5
B	get_final_payment_date()	0	30	4
A	get_start_date()	0	2	1
A	set_first_payment_date()	0	2	1
A	get_renewal_notice_date()	0	8	2
A	get_next_payment_date()	0	23	3
A	get_first_payment()	0	8	2
A	set_expiry_date()	0	2	1
A	get_first_payment_date()	0	2	1
A	set_renewal_notice_date()	0	2	1
A	set_final_payment_date()	0	2	1
A	set_next_payment_date()	0	5	2
A	set_start_date()	0	2	1

<?php
/**
 * Subscription
 *
 * @author    Pronamic <info@pronamic.eu>
 * @copyright 2005-2018 Pronamic
 * @license   GPL-3.0-or-later
 * @package   Pronamic\WordPress\Pay\Subscriptions
 */

namespace Pronamic\WordPress\Pay\Subscriptions;

use DateInterval;
use DateTime;
use DateTimeZone;
use Pronamic\WordPress\Pay\Plugin;
use Pronamic_IDeal_IDeal;

The type Pronamic_IDeal_IDeal was not found. Maybe you did not declare it correctly or list all dependencies?

use Pronamic\WordPress\Pay\Core\Statuses;
use Pronamic\WordPress\Pay\Util;

/**
 * Subscription.
 */
class Subscription {
	/**
	 * The ID of this subscription.
	 *
	 * @var string
	 */
	protected $id;

	/**
	 * The key of this subscription, used in URL's for security.
	 *
	 * @var string
	 */
	public $key;

	/**
	 * The frequency of this subscription, for example: `daily`, `weekly`, `monthly` or `annually`.
	 *
	 * @var string
	 */
	public $frequency;

	/**
	 * The interval of this subscription, for example: 1, 2, 3, etc.
	 *
	 * @todo Improve documentation?
	 * @var  int
	 */
	public $interval;

	/**
	 * The interval period of this subscription.
	 *
	 * @todo Improve documentation?
	 * @var  int
	 */
	public $interval_period;

	/**
	 * The transaction ID of this subscription.
	 *
	 * @todo Is this required within a transaction?
	 * @var string
	 */
	public $transaction_id;

	/**
	 * The description of this subscription.
	 *
	 * @todo Is this required within a transaction?
	 * @var string
	 */
	public $description;

	/**
	 * The currency of this subscription, for example 'EUR' or 'USD'.
	 *
	 * @var string
	 */
	public $currency;

	/**
	 * The amount of this subscription, for example 18.95.
	 *
	 * @var float
	 */
	public $amount;

	/**
	 * The status of this subscription, for example 'Success'.
	 *
	 * @todo How to reference to a class constant?
	 * @see  Pronamic\WordPress\Pay\Core\Statuses
	 * @var  string
	 */
	public $status;

	/**
	 * Identifier for the source which started this subsription.
	 * For example: 'woocommerce', 'gravityforms', 'easydigitaldownloads', etc.
	 *
	 * @var string
	 */
	public $source;

	/**
	 * Unique ID at the source which started this subscription, for example:
	 * - WooCommerce order ID.
	 * - Easy Digital Downloads payment ID.
	 * - Gravity Forms entry ID.
	 *
	 * @var string
	 */
	public $source_id;

	/**
	 * The name of the consumer of this subscription.
	 *
	 * @todo Is this required and should we add the 'consumer' part?
	 * @var  string
	 */
	public $consumer_name;

	/**
	 * The IBAN of the consumer of this subscription.
	 *
	 * @todo Is this required and should we add the 'consumer' part?
	 * @var  string
	 */
	public $consumer_iban;

	/**
	 * The BIC of the consumer of this subscription.
	 *
	 * @todo Is this required and should we add the 'consumer' part?
	 * @var  string
	 */
	public $consumer_bic;

	/**
	 * The order ID of this subscription.
	 *
	 * @todo Is this required?
	 * @var  string
	 */
	public $order_id;

	/**
	 * The address of the consumer of this subscription.
	 *
	 * @todo Is this required?
	 * @var  string
	 */
	public $address;

	/**
	 * The city of the consumer of this subscription.
	 *
	 * @todo Is this required?
	 * @var  string
	 */
	public $city;

	/**
	 * The ZIP of the consumer of this subscription.
	 *
	 * @todo Is this required?
	 * @var  string
	 */
	public $zip;

	/**
	 * The country of the consumer of this subscription.
	 *
	 * @todo Is this required?
	 * @var  string
	 */
	public $country;

	/**
	 * The telephone number of the consumer of this subscription.
	 *
	 * @todo Is this required?
	 * @var  string
	 */
	public $telephone_number;

	/**
	 * The gateway configuration ID to use with this subscription.
	 *
	 * @todo Should we improve the name of this var?
	 * @var  string
	 */
	public $config_id;

	/**
	 * The email of the consumer of this subscription.
	 *
	 * @todo Is this required?
	 * @var  string
	 */
	public $email;

	/**
	 * The customer name of the consumer of this subscription.
	 *
	 * @todo Is this required?
	 * @var  string
	 */
	public $customer_name;

	/**
	 * The payment method which was used to create this subscription.
	 *
	 * @var  string
	 */
	public $payment_method;

	/**
	 * The date when this subscirption started.
	 *
	 * @var DateTime
	 */
	public $start_date;

	/**
	 * The end date of the last succesfull payment.
	 *
	 * @var DateTime
	 */
	public $expiry_date;

	/**
	 * The date of the first payment.
	 *
	 * @todo Is this required? And is this not equeal to start date of the subscription?
	 * @var DateTime
	 */
	public $first_payment;

	/**
	 * The next payment date.
	 *
	 * @todo Is this required?
	 * @var DateTime
	 */
	public $next_payment;

	/**
	 * The final payment date, can be null if the subscrption never ends.
	 *
	 * @todo Is this required?
	 * @var DateTime
	 */
	public $final_payment;

	/**
	 * The renewal notice date.
	 *
	 * @todo Is this required?
	 * @var DateTime
	 */
	public $renewal_notice;

	/**
	 * Array for extra meta data to store with this subscription.
	 *
	 * @var array
	 */
	public $meta;

	/**
	 * WordPress post object related to this subscription.
	 *
	 * @var \WP_Post
	 */
	public $post;

	/**
	 * Construct and initialize payment object.
	 *
	 * @param int $post_id A subscription post ID or null.
	 */
	public function __construct( $post_id = null ) {
		$this->id   = $post_id;
		$this->date = new \DateTime();

The property date does not exist. Although not strictly required by PHP, it is generally a best practice to declare properties explicitly.

		$this->meta = array();

		if ( null !== $post_id ) {
			global $pronamic_ideal;

			$pronamic_ideal->subscriptions_data_store->read( $this );
		}
	}

	/**
	 * Get the ID of this subscription.
	 *
	 * @return string
	 */
	public function get_id() {
		return $this->id;
	}

	/**
	 * Set the ID of this subscription.
	 *
	 * @param string $id The ID of this subscription.
	 */
	public function set_id( $id ) {
		$this->id = $id;
	}

	/**
	 * Get the unique key of this subscription.
	 *
	 * @return string
	 */
	public function get_key() {
		return $this->key;
	}

	/**
	 * Get the source identifier of this subscription, for example: 'woocommerce', 'gravityforms', etc.
	 *
	 * @return string
	 */
	public function get_source() {
		return $this->source;
	}

	/**
	 * Get the source ID of this subscription, for example a WooCommerce order ID or a Gravity Forms entry ID.
	 *
	 * @return string
	 */
	public function get_source_id() {
		return $this->source_id;
	}

	/**
	 * Get the frequency of this subscription, for example: 'daily', 'weekly', 'monthly' or 'annually'.
	 *
	 * @return string
	 */
	public function get_frequency() {
		return $this->frequency;
	}

	/**
	 * Get the interval, for example: 1, 2, 3, 4, etc., this specifies for example:
	 * - Repeat every *2* days
	 * - Repeat every *1* months
	 * - Repeat every *2* year
	 *
	 * @return int
	 */
	public function get_interval() {
		return $this->interval;
	}

	/**
	 * Get the interval period, for example 'D', 'M', 'Y', etc.
	 *
	 * @see    http://php.net/manual/en/dateinterval.construct.php#refsect1-dateinterval.construct-parameters
	 * @return string
	 */
	public function get_interval_period() {
		return $this->interval_period;
	}

	/**
	 * Get date interval.
	 *
	 * @see http://php.net/manual/en/dateinterval.construct.php#refsect1-dateinterval.construct-parameters
	 * @return \DateInterval
	 * @throws \Exception    Throws an Exception when the `interval_spec` cannot be parsed as an interval.
	 */
	public function get_date_interval() {
		$interval_spec = 'P' . $this->interval . $this->interval_period;

		$interval = new DateInterval( $interval_spec );

		return $interval;
	}

	/**
	 * Get the description of this subscription.
	 *
	 * @return string
	 */
	public function get_description() {
		return $this->description;
	}

	/**
	 * Get the currency of this subscription.
	 *
	 * @return string
	 */
	public function get_currency() {
		return $this->currency;
	}

	/**
	 * Get the amount of this subscription.
	 *
	 * @return float
	 */
	public function get_amount() {
		return $this->amount;
	}

	/**
	 * Get the transaction ID of this subscription.
	 *
	 * @return string
	 */
	public function get_transaction_id() {
		return $this->transaction_id;
	}

	/**
	 * Set the transaction ID of this subscription.
	 *
	 * @param string $transaction_id A transaction ID.
	 */
	public function set_transaction_id( $transaction_id ) {
		$this->transaction_id = $transaction_id;
	}

	/**
	 * Get the status of this subscription.
	 *
	 * @todo   Check constant?
	 * @return string
	 */
	public function get_status() {
		return $this->status;
	}

	/**
	 * Set the status of this subscription.
	 *
	 * @todo  Check constant?
	 * @param string $status A status string.
	 */
	public function set_status( $status ) {
		$this->status = $status;
	}

	/**
	 * Set consumer name.
	 *
	 * @param string $name A name.
	 */
	public function set_consumer_name( $name ) {
		$this->consumer_name = $name;
	}

	/**
	 * Set consumer IBAN.
	 *
	 * @param string $iban A IBAN.
	 */
	public function set_consumer_iban( $iban ) {
		$this->consumer_iban = $iban;
	}

	/**
	 * Set consumer BIC.
	 *
	 * @param string $bic A BIC.
	 */
	public function set_consumer_bic( $bic ) {
		$this->consumer_bic = $bic;
	}

	/**
	 * Add the specified note to this subscription.
	 *
	 * @param string $note A Note.
	 */
	public function add_note( $note ) {
		$commentdata = array(
			'comment_post_ID'      => $this->id,
			'comment_author'       => 'admin',
			'comment_author_email' => 'admin@admin.com',
			'comment_author_url'   => 'http://',
			'comment_content'      => $note,
			'comment_type'         => 'subscription_note',
			'comment_parent'       => 0,
			'user_id'              => 0,
			'comment_approved'     => 1,
		);

		$comment_id = wp_insert_comment( $commentdata );

		return $comment_id;
	}

	/**
	 * Get meta by the specified meta key.
	 *
	 * @param string $key A meta key.
	 * @return string
	 */
	public function get_meta( $key ) {
		$key = '_pronamic_subscription_' . $key;

		return get_post_meta( $this->id, $key, true );

$this->id of type string is incompatible with the type integer expected by parameter $post_id of get_post_meta().

	}

	/**
	 * Set meta data.
	 *
	 * @param  string $key   A meta key.
	 * @param  mixed  $value A meta value.
	 *
	 * @return boolean        True on successful update, false on failure.
	 */
	public function set_meta( $key, $value = false ) {
		$key = '_pronamic_subscription_' . $key;

		if ( $value instanceof DateTime ) {
			$value = $value->format( 'Y-m-d H:i:s' );
		}

		if ( empty( $value ) ) {
			return delete_post_meta( $this->id, $key );

$this->id of type string is incompatible with the type integer expected by parameter $post_id of delete_post_meta().

		}

		return update_post_meta( $this->id, $key, $value );

$this->id of type string is incompatible with the type integer expected by parameter $post_id of update_post_meta().

	}

	/**
	 * Get source description.
	 *
	 * @return string
	 */
	public function get_source_description() {
		$description = $this->source;

		$payment = $this->get_first_payment();

		if ( $payment ) {
			$description = apply_filters( 'pronamic_payment_source_description', $description, $payment );
			$description = apply_filters( 'pronamic_payment_source_description_' . $this->source, $description, $payment );
		}

		return $description;
	}

	/**
	 * Get source link for this subscription.
	 *
	 * @return string
	 */
	public function get_source_link() {
		$url = null;

		$payment = $this->get_first_payment();

		if ( $payment ) {
			$url = apply_filters( 'pronamic_payment_source_url', $url, $payment );
			$url = apply_filters( 'pronamic_payment_source_url_' . $this->source, $url, $payment );
		}

		return $url;
	}

	/**
	 * Get cancel URL for this subscription.
	 *
	 * @return string
	 */
	public function get_cancel_url() {
		$cancel_url = add_query_arg(
			array(
				'subscription' => $this->get_id(),
				'key'          => $this->get_key(),
				'action'       => 'cancel',
			), home_url()
		);

		return $cancel_url;
	}

	/**
	 * Get renewal URL for this subscription.
	 *
	 * @return string
	 */
	public function get_renewal_url() {
		$renewal_url = add_query_arg(
			array(
				'subscription' => $this->get_id(),
				'key'          => $this->get_key(),
				'action'       => 'renew',
			), home_url()
		);

		return $renewal_url;
	}

	/**
	 * Get all the payments for this subscription.
	 *
	 * @return array
	 */
	public function get_payments() {
		return get_pronamic_payments_by_meta( '_pronamic_payment_subscription_id', $this->id );
	}

	/**
	 * Get the first payment of this subscription.
	 *
	 * @return Payment

The type Pronamic\WordPress\Pay\Subscriptions\Payment was not found. Maybe you did not declare it correctly or list all dependencies?

	 */
	public function get_first_payment() {
		$payments = $this->get_payments();

		if ( count( $payments ) > 0 ) {
			return $payments[0];
		}

		return null;
	}

	/**
	 * Set the start date of this subscription.
	 *
	 * @todo  Should we set meta directly?
	 * @param string $value A date value.
	 */
	public function set_start_date( $value ) {
		$this->start_date = $value;

It seems like $value of type string is incompatible with the declared type DateTime of property $start_date.

	}

	/**
	 * Get the start date of this subscription.
	 *
	 * @todo Should we handle logic in this getter?
	 * @return DateTime|null
	 */
	public function get_start_date() {
		return $this->start_date;
	}

	/**
	 * Set the expiry date of this subscription.
	 *
	 * @todo  Should we set meta directly?
	 * @param string $value A date value.
	 */
	public function set_expiry_date( $value ) {

The parameter $value is not used and could be removed.

		$this->expiry_date = $expiry_date;

The variable $expiry_date seems to be never defined.

	}

	/**
	 * Get the expiry date of this subscription.
	 *
	 * @todo Should we handle logic in this getter?
	 * @return DateTime
	 */
	public function get_expiry_date() {
		return $this->expiry_date;
	}

	/**
	 * Set the first payment date of this subscription.
	 *
	 * @todo  Should we set meta directly?
	 * @param string $value A date value.
	 */
	public function set_first_payment_date( $value ) {
		$this->first_payment = $value;

It seems like $value of type string is incompatible with the declared type DateTime of property $first_payment.

	}

	/**
	 * Get the first payment date of this subscription.
	 *
	 * @todo Should we handle logic in this getter?
	 * @return DateTime
	 */
	public function get_first_payment_date() {
		return $this->first_payment;
	}

	/**
	 * Set the final payment date of this subscription.
	 *
	 * @todo  Should we set meta directly?
	 * @param string $value A date value.
	 */
	public function set_final_payment_date( $value ) {
		$this->set_meta( 'final_payment', $value );
	}

	/**
	 * Get the final payment date of this subscription.
	 *
	 * @todo Should we handle logic in this getter?
	 * @return DateTime
	 */
	public function get_final_payment_date() {
		return $this->final_payment;

		$final = $this->get_meta( 'final_payment' );

$final = $this->get_meta('final_payment') is not reachable.

		if ( '' !== $final ) {
			return new DateTime( $final );
		}

		// If no frequency is set, use next payment or start date.
		$frequency = $this->get_frequency();

		if ( '' === $frequency ) {
			$next_date = $this->get_next_payment_date();

			if ( null === $next_date ) {
				return $this->get_start_date();
			}

			return $next_date;
		}

		// Add frequency * interval period to first payment date.
		$first_date = $this->get_first_payment_date();

		return $first_date->modify(
			sprintf(
				'+%d %s',
				( $frequency - 1 ) * $this->get_interval(),
				Util::to_interval_name( $this->get_interval_period() )
			)
		);
	}

	/**
	 * Set the next payment date of this subscription.
	 *
	 * @todo  Should we set meta directly?
	 * @param string $value A date value.
	 */
	public function set_next_payment_date( $value ) {
		$this->set_meta( 'next_payment', $value );

		if ( false === $value ) {

The condition false === $value is always false.

			$this->set_renewal_notice_date( false );
		}
	}

	/**
	 * Get the next payment date of this subscription.
	 *
	 * @todo   Should we handle logic in this getter?
	 * @param  int $cycle TODO.
	 * @return DateTime
	 */
	public function get_next_payment_date( $cycle = 0 ) {

The parameter $cycle is not used and could be removed.

		return $this->next_payment;

		// Meta next_payment, possibly doesn't exist if last payment has been processed.
		$next_payment = $this->get_meta( 'next_payment' );

$next_payment = $this->get_meta('next_payment') is not reachable.

		if ( '' === $next_payment ) {
			return;
		}

		$next = new DateTime( $next_payment );

		if ( 0 !== $cycle ) {
			$next->modify(
				sprintf(
					'+%d %s',
					( $cycle * $this->get_interval() ),
					Util::to_interval_name( $this->get_interval_period() )
				)
			);
		}

		return $next;
	}

	/**
	 * Set the renewal notice date of this subscription.
	 *
	 * @todo  Should we set meta directly?
	 * @param string $value A date value.
	 */
	public function set_renewal_notice_date( $value ) {
		$this->set_meta( 'renewal_notice', $value );
	}

	/**
	 * Get the renewal notice date of this subscription.
	 *
	 * @todo   Should we handle logic in this getter?
	 * @return DateTime
	 */
	public function get_renewal_notice_date() {
		$renewal_notice = $this->get_meta( 'renewal_notice' );

		if ( '' !== $renewal_notice ) {
			return $renewal_notice;
		}

		return false;
	}

	/**
	 * Update meta.
	 *
	 * @todo  Not sure how and when this function is used.
	 * @param array $meta The meta data to update.
	 */
	public function update_meta( $meta ) {
		if ( ! is_array( $meta ) || count( $meta ) === 0 ) {

The condition is_array($meta) is always true.

			return;
		}

		$note = sprintf(
			'<p>%s:</p>',
			__( 'Subscription changed', 'pronamic_ideal' )
		);

		$note .= '<dl>';

		foreach ( $meta as $key => $value ) {
			$this->set_meta( $key, $value );

			if ( $value instanceof DateTime ) {
				$value = date_i18n( __( 'l jS \o\f F Y, h:ia', 'pronamic_ideal' ), $value->getTimestamp() );
			}

			$note .= sprintf( '<dt>%s</dt>', esc_html( $key ) );
			$note .= sprintf( '<dd>%s</dd>', esc_html( $value ) );
		}

		$note .= '</dl>';

		$this->add_note( $note );
	}
}