<?php
/**
 * Base class for form integrations.
 *
 * @package Dealroot
 */

namespace Dealroot\Forms;

defined( 'ABSPATH' ) || exit;

/**
 * Shared contract for form plugin adapters.
 */
abstract class Integration {

	/**
	 * Whether the form plugin is active.
	 *
	 * @return bool
	 */
	abstract public static function is_available();

	/**
	 * Short machine key stored with each lead.
	 *
	 * @return string
	 */
	abstract public static function key();

	/**
	 * Display name.
	 *
	 * @return string
	 */
	abstract public static function label();

	/**
	 * Hooks into the form plugin.
	 */
	abstract public function register();

	/**
	 * Title of a form, as stored with its leads. Names the form in the form analytics.
	 *
	 * @param int $form_id Form ID.
	 * @return string '' when unknown.
	 */
	public static function form_title( $form_id ) {
		unset( $form_id );

		return '';
	}

	/**
	 * Title of a post that holds a form of the plugin.
	 *
	 * @param int    $form_id   Post ID.
	 * @param string $post_type Post type of the plugin's forms.
	 * @return string
	 */
	protected static function post_title( $form_id, $post_type ) {
		$post = get_post( (int) $form_id );

		return $post && $post_type === $post->post_type ? (string) $post->post_title : '';
	}
}