initial commit

includes/legacy/abstract-wc-legacy-payment-token.php

@@ -0,0 +1,70 @@
+<?php
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Legacy Payment Tokens.
+ * Payment Tokens were introduced in 2.6.0 with create and update as methods.
+ * Major CRUD changes occurred in 3.0, so these were deprecated (save and delete still work).
+ * This legacy class is for backwards compatibility in case any code called ->read, ->update or ->create
+ * directly on the object.
+ *
+ * @version  3.0.0
+ * @package  WooCommerce\Classes
+ * @category Class
+ * @author   WooCommerce
+ */
+abstract class WC_Legacy_Payment_Token extends WC_Data {
+
+	/**
+	 * Sets the type of this payment token (CC, eCheck, or something else).
+	 *
+	 * @param string Payment Token Type (CC, eCheck)
+	 */
+	public function set_type( $type ) {
+		wc_deprecated_function( 'WC_Payment_Token::set_type', '3.0.0', 'Type cannot be overwritten.' );
+	}
+
+	/**
+	 * Read a token by ID.
+	 * @deprecated 3.0.0 - Init a token class with an ID.
+	 *
+	 * @param int $token_id
+	 */
+	public function read( $token_id ) {
+		wc_deprecated_function( 'WC_Payment_Token::read', '3.0.0', 'a new token class initialized with an ID.' );
+		$this->set_id( $token_id );
+		$data_store = WC_Data_Store::load( 'payment-token' );
+		$data_store->read( $this );
+	}
+
+	/**
+	 * Update a token.
+	 * @deprecated 3.0.0 - Use ::save instead.
+	 */
+	public function update() {
+		wc_deprecated_function( 'WC_Payment_Token::update', '3.0.0', 'WC_Payment_Token::save instead.' );
+		$data_store = WC_Data_Store::load( 'payment-token' );
+		try {
+			$data_store->update( $this );
+		} catch ( Exception $e ) {
+			return false;
+		}
+	}
+
+	/**
+	 * Create a token.
+	 * @deprecated 3.0.0 - Use ::save instead.
+	 */
+	public function create() {
+		wc_deprecated_function( 'WC_Payment_Token::create', '3.0.0', 'WC_Payment_Token::save instead.' );
+		$data_store = WC_Data_Store::load( 'payment-token' );
+		try {
+			$data_store->create( $this );
+		} catch ( Exception $e ) {
+			return false;
+		}
+	}
+
+}