# suredonation/0.0.1/inc/fields/base.php

SureDonation – Donation Forms, Fundraising Campaigns & Donor Management, version 0.0.1. 442 lines.

- Page: https://pluginprobe.com/plugins/suredonation/0.0.1/code/inc/fields/base.php
- Raw: https://pluginprobe.com/plugins/suredonation/0.0.1/raw/inc/fields/base.php
- Modified: 2026-03-04T10:31:12+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/suredonation/0.0.1/code/inc/fields/base.php#L10-L20`.

```php
<?php
/**
 * Form Field Base Class.
 *
 * This file defines the base class for form field markup in the SureDonation package.
 *
 * @package SureDonation
 * @since 0.0.1
 */

namespace SureDonation\Inc\Fields;

use SureDonation\Inc\Helper;

if ( ! defined( 'ABSPATH' ) ) {
	exit; // Exit if accessed directly.
}

/**
 * Field Base Class
 *
 * Defines the base class for form field markup generation.
 *
 * @since 0.0.1
 */
class Base {
	/**
	 * Stores the attributes of the block.
	 *
	 * @var array<string, mixed> $attributes Block attributes.
	 * @since 0.0.1
	 */
	protected $attributes = [];

	/**
	 * Flag indicating if the field is required.
	 *
	 * @var bool
	 * @since 0.0.1
	 */
	protected $required = false;

	/**
	 * Width of the field (percentage).
	 *
	 * @var string
	 * @since 0.0.1
	 */
	protected $field_width = '';

	/**
	 * Stores the label for the field.
	 *
	 * @var string $label Label used for the input field.
	 * @since 0.0.1
	 */
	protected $label = '';

	/**
	 * Stores the help text.
	 *
	 * @var string $help
	 * @since 0.0.1
	 */
	protected $help = '';

	/**
	 * Validation error message for the field.
	 *
	 * @var string $error_msg Input field validation error message.
	 * @since 0.0.1
	 */
	protected $error_msg = '';

	/**
	 * Unique identifier for the block.
	 *
	 * @var string $block_id Unique identifier representing the block.
	 * @since 0.0.1
	 */
	protected $block_id = '';

	/**
	 * Stores the ID of the form.
	 *
	 * @var string $form_id Form ID.
	 * @since 0.0.1
	 */
	protected $form_id = '';

	/**
	 * Stores the block slug.
	 *
	 * @var string
	 * @since 0.0.1
	 */
	protected $block_slug = '';

	/**
	 * Stores the slug type (e.g., 'input', 'email').
	 *
	 * @var string $slug slug value.
	 * @since 0.0.1
	 */
	protected $slug = '';

	/**
	 * Data-required attribute value.
	 *
	 * @var string $data_require_attr Value of the data-required attribute.
	 * @since 0.0.1
	 */
	protected $data_require_attr = 'false';

	/**
	 * CSS class for block width.
	 *
	 * @var string $block_width The CSS class for block width.
	 * @since 0.0.1
	 */
	protected $block_width = '';

	/**
	 * Stores custom class names.
	 *
	 * @var string $class_name The value of the class name attribute.
	 * @since 0.0.1
	 */
	protected $class_name = '';

	/**
	 * Stores the placeholder text.
	 *
	 * @var string $placeholder HTML field placeholder.
	 * @since 0.0.1
	 */
	protected $placeholder = '';

	/**
	 * Stores the HTML placeholder attribute.
	 *
	 * @var string $placeholder_attr HTML field placeholder attribute.
	 * @since 0.0.1
	 */
	protected $placeholder_attr = '';

	/**
	 * Default value for the field.
	 *
	 * @var string
	 * @since 0.0.1
	 */
	protected $default = '';

	/**
	 * HTML attribute string for the default value.
	 *
	 * @var string
	 * @since 0.0.1
	 */
	protected $default_value_attr = '';

	/**
	 * Unique slug combining slug and block ID.
	 *
	 * @var string
	 * @since 0.0.1
	 */
	protected $unique_slug = '';

	/**
	 * Stores the field name for form submission.
	 *
	 * @var string $field_name HTML field name.
	 * @since 0.0.1
	 */
	protected $field_name = '';

	/**
	 * Options for select/checkbox/radio fields.
	 *
	 * @var array<mixed>
	 * @since 0.0.1
	 */
	protected $options = [];

	/**
	 * Checked state for the field.
	 *
	 * @var string
	 * @since 0.0.1
	 */
	protected $checked = '';

	/**
	 * HTML attribute string for the checked state.
	 *
	 * @var string
	 * @since 0.0.1
	 */
	protected $checked_attr = '';

	/**
	 * Stores the help text markup.
	 *
	 * @var string
	 * @since 0.0.1
	 */
	protected $help_markup = '';

	/**
	 * Stores the error message markup.
	 *
	 * @var string
	 * @since 0.0.1
	 */
	protected $error_msg_markup = '';

	/**
	 * Stores the HTML label markup.
	 *
	 * @var string
	 * @since 0.0.1
	 */
	protected $label_markup = '';

	/**
	 * Render the field markup.
	 *
	 * @return string
	 * @since 0.0.1
	 */
	public function markup() {
		return '';
	}

	/**
	 * Get CSS classes for the field wrapper.
	 *
	 * @param array<string> $extra_classes Extra classes to be added.
	 * @since 0.0.1
	 * @return string
	 */
	public function get_field_classes( $extra_classes = [] ) {
		$common_classes = [
			'sd-block-single',
			'sd-block',
			"sd-{$this->slug}-block",
			"sd-{$this->slug}-{$this->block_id}-block",
			$this->block_width,
			$this->class_name,
		];

		if ( $this->block_slug ) {
			$common_classes[] = "sd-slug-{$this->block_slug}";
		}

		if ( ! empty( $extra_classes ) && is_array( $extra_classes ) ) {
			$common_classes = array_merge( $common_classes, $extra_classes );
		}

		return Helper::join_strings( $common_classes );
	}

	/**
	 * Setter for the properties of class based on block attributes.
	 *
	 * @param array<string, mixed> $attributes Block attributes.
	 * @since 0.0.1
	 * @return void
	 */
	protected function set_properties( $attributes ) {
		$this->attributes         = $attributes;
		$this->required           = ! empty( $attributes['required'] );
		$this->field_width        = isset( $attributes['fieldWidth'] ) ? Helper::get_string_value( $attributes['fieldWidth'] ) : '';
		$this->label              = isset( $attributes['label'] ) ? Helper::get_string_value( $attributes['label'] ) : '';
		$this->help               = isset( $attributes['help'] ) ? Helper::get_string_value( $attributes['help'] ) : '';
		$this->error_msg          = isset( $attributes['errorMsg'] ) ? Helper::get_string_value( $attributes['errorMsg'] ) : '';
		$this->block_id           = isset( $attributes['block_id'] ) ? Helper::get_string_value( $attributes['block_id'] ) : '';
		$this->form_id            = isset( $attributes['formId'] ) ? Helper::get_string_value( $attributes['formId'] ) : '';
		$this->block_slug         = isset( $attributes['slug'] ) ? Helper::get_string_value( $attributes['slug'] ) : '';
		$this->placeholder        = isset( $attributes['placeholder'] ) ? Helper::get_string_value( $attributes['placeholder'] ) : '';
		$this->default            = isset( $attributes['defaultValue'] ) ? Helper::get_string_value( $attributes['defaultValue'] ) : '';
		$this->checked            = isset( $attributes['checked'] ) ? Helper::get_string_value( $attributes['checked'] ) : '';
		$this->options            = isset( $attributes['options'] ) && is_array( $attributes['options'] ) ? $attributes['options'] : [];
		$this->class_name         = isset( $attributes['className'] ) && is_string( $attributes['className'] ) ? ' ' . $attributes['className'] : '';
		$this->data_require_attr  = $this->required ? 'true' : 'false';
		$this->block_width        = $this->field_width ? ' sd-block-width-' . str_replace( '.', '-', $this->field_width ) : '';
		$this->placeholder_attr   = '' !== $this->placeholder ? ' placeholder="' . esc_attr( $this->placeholder ) . '" ' : '';
		$this->default_value_attr = '' !== $this->default ? ' value="' . esc_attr( $this->default ) . '" ' : '';
		$this->checked_attr       = $this->checked ? 'checked' : '';
	}

	/**
	 * Set the unique slug for the field.
	 *
	 * @since 0.0.1
	 * @return void
	 */
	protected function set_unique_slug() {
		$this->unique_slug = 'sd-' . $this->slug . '-' . $this->block_id;
		$this->field_name  = $this->unique_slug;
	}

	/**
	 * Set markup properties (label, help, error).
	 *
	 * @since 0.0.1
	 * @return void
	 */
	protected function set_markup_properties() {
		$this->label_markup     = $this->generate_label_markup();
		$this->help_markup      = $this->generate_help_markup();
		$this->error_msg_markup = $this->generate_error_markup();
	}

	/**
	 * Generate label markup.
	 *
	 * @since 0.0.1
	 * @return string
	 */
	protected function generate_label_markup() {
		if ( empty( $this->label ) ) {
			return '';
		}

		$required_mark = $this->required ? '<span class="sd-required" aria-hidden="true">*</span>' : '';

		return sprintf(
			'<label for="%s" class="sd-label">%s%s</label>',
			esc_attr( $this->unique_slug ),
			esc_html( $this->label ),
			$required_mark
		);
	}

	/**
	 * Generate help text markup.
	 *
	 * @since 0.0.1
	 * @return string
	 */
	protected function generate_help_markup() {
		if ( empty( $this->help ) ) {
			return '';
		}

		return sprintf(
			'<p id="sd-help-%s" class="sd-help">%s</p>',
			esc_attr( $this->block_id ),
			esc_html( $this->help )
		);
	}

	/**
	 * Generate error message markup.
	 *
	 * @since 0.0.1
	 * @return string
	 */
	protected function generate_error_markup() {
		$error_text = $this->error_msg ? $this->error_msg : __( 'This field is required.', 'suredonation' );

		return sprintf(
			'<p id="sd-error-%s" class="sd-error" role="alert" style="display: none;">%s</p>',
			esc_attr( $this->block_id ),
			esc_html( $error_text )
		);
	}

	/**
	 * Get aria-describedby attribute value.
	 *
	 * @since 0.0.1
	 * @return string
	 */
	protected function get_aria_describedby() {
		$describedby = [];

		if ( ! empty( $this->help ) ) {
			$describedby[] = 'sd-help-' . $this->block_id;
		}

		$describedby[] = 'sd-error-' . $this->block_id;

		return implode( ' ', $describedby );
	}

	/**
	 * Darken a hex color by a percentage.
	 *
	 * @param string $hex     Hex color code.
	 * @param int    $percent Percentage to darken (0-100).
	 * @return string Darkened hex color.
	 * @since 0.0.1
	 */
	protected function darken_color( $hex, $percent = 15 ) {
		$hex = ltrim( $hex, '#' );

		if ( strlen( $hex ) === 3 ) {
			$hex = $hex[0] . $hex[0] . $hex[1] . $hex[1] . $hex[2] . $hex[2];
		}

		$r = hexdec( substr( $hex, 0, 2 ) );
		$g = hexdec( substr( $hex, 2, 2 ) );
		$b = hexdec( substr( $hex, 4, 2 ) );

		$r = max( 0, $r - ( $r * $percent / 100 ) );
		$g = max( 0, $g - ( $g * $percent / 100 ) );
		$b = max( 0, $b - ( $b * $percent / 100 ) );

		return sprintf( '#%02x%02x%02x', $r, $g, $b );
	}

	/**
	 * Lighten a hex color by a percentage.
	 *
	 * @param string $hex     Hex color code.
	 * @param int    $percent Percentage to lighten (0-100).
	 * @return string Lightened hex color.
	 * @since 0.0.1
	 */
	protected function lighten_color( $hex, $percent = 90 ) {
		$hex = ltrim( $hex, '#' );

		if ( strlen( $hex ) === 3 ) {
			$hex = $hex[0] . $hex[0] . $hex[1] . $hex[1] . $hex[2] . $hex[2];
		}

		$r = hexdec( substr( $hex, 0, 2 ) );
		$g = hexdec( substr( $hex, 2, 2 ) );
		$b = hexdec( substr( $hex, 4, 2 ) );

		$r = min( 255, $r + ( ( 255 - $r ) * $percent / 100 ) );
		$g = min( 255, $g + ( ( 255 - $g ) * $percent / 100 ) );
		$b = min( 255, $b + ( ( 255 - $b ) * $percent / 100 ) );

		return sprintf( '#%02x%02x%02x', $r, $g, $b );
	}
}

```