| Server IP : 104.21.30.238 / Your IP : 216.73.216.145 Web Server : LiteSpeed System : Linux premium151.web-hosting.com 4.18.0-553.44.1.lve.el8.x86_64 #1 SMP Thu Mar 13 14:29:12 UTC 2025 x86_64 User : tempvsty ( 647) PHP Version : 8.0.30 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : OFF | Pkexec : OFF Directory : /././proc/self/cwd/wp-content/plugins/wpforms-lite/src/Forms/Fields/Traits/ |
Upload File : |
<?php
namespace WPForms\Forms\Fields\Traits;
trait CameraTrait {
/**
* Add camera options to the field.
*
* @since 1.9.8
*
* @param array $field Field data and settings.
*/
public function camera_options( array $field ): void {
$this->add_camera_enabled_toggle( $field );
$this->add_camera_format_options( $field );
$this->add_camera_aspect_ratio_options( $field );
$this->add_camera_custom_ratio_options( $field );
$this->add_camera_time_limit_options( $field );
}
/**
* Add camera-enabled toggle.
*
* @since 1.9.8
*
* @param array $field Field data and settings.
*/
private function add_camera_enabled_toggle( array $field ): void {
// Check if this is a Camera field (not FileUpload with camera options).
$is_camera_field = $this->type === 'camera';
$camera_enabled = $this->field_element(
'toggle',
$field,
[
'slug' => 'camera_enabled',
'value' => $this->is_camera_enabled_for_field( $field ) ? 1 : '',
'desc' => esc_html__( 'Enable Camera', 'wpforms-lite' ),
'tooltip' => esc_html__( 'Check this option to enable the camera field.', 'wpforms-lite' ),
'class' => 'wpforms-file-upload-camera-enabled-toggle',
],
false
);
// Hide the toggle for the Camera field, show for FileUpload field.
$row_class = [ 'wpforms-file-upload-camera-enabled-row' ];
if ( $is_camera_field ) {
$row_class[] = 'wpforms-hidden';
}
$this->field_element(
'row',
$field,
[
'slug' => 'camera',
'content' => $camera_enabled,
'class' => $row_class,
]
);
}
/**
* Add camera format options.
*
* @since 1.9.8
*
* @param array $field Field data and settings.
*/
private function add_camera_format_options( array $field ): void {
$format_label = $this->field_element(
'label',
$field,
[
'slug' => 'camera_format',
'value' => esc_html__( 'Format', 'wpforms-lite' ),
'tooltip' => esc_html__( 'Select the camera format.', 'wpforms-lite' ),
'class' => 'wpforms-file-upload-camera-format-label',
],
false
);
$format_select = $this->field_element(
'select',
$field,
[
'slug' => 'camera_format',
'value' => ! empty( $field['camera_format'] ) ? $field['camera_format'] : 'photo',
'options' => [
'photo' => esc_html__( 'Photo', 'wpforms-lite' ),
'video' => esc_html__( 'Video', 'wpforms-lite' ),
],
'class' => 'wpforms-file-upload-camera-format-select',
],
false
);
// Check if the camera is enabled to determine visibility.
$hidden_class = $this->is_camera_enabled_for_field( $field ) ? [] : [ 'wpforms-hidden' ];
$this->field_element(
'row',
$field,
[
'slug' => 'camera_format',
'content' => $format_label . $format_select,
'class' => array_merge( [ 'wpforms-file-upload-camera-format' ], $hidden_class ),
]
);
}
/**
* Add camera aspect ratio options.
*
* @since 1.9.8
*
* @param array $field Field data and settings.
*/
private function add_camera_aspect_ratio_options( array $field ): void {
$aspect_ratio_label = $this->field_element(
'label',
$field,
[
'slug' => 'camera_aspect_ratio',
'value' => esc_html__( 'Aspect Ratio', 'wpforms-lite' ),
'tooltip' => esc_html__( 'Select the camera aspect ratio.', 'wpforms-lite' ),
'class' => 'wpforms-file-upload-camera-aspect-ratio-label',
],
false
);
// Build aspect ratio options - always include freeform.
$aspect_ratio_options = [
'original' => esc_html__( 'Original', 'wpforms-lite' ),
'custom' => esc_html__( 'Custom', 'wpforms-lite' ),
'freeform' => esc_html__( 'Freeform', 'wpforms-lite' ),
'landscape' => [
'optgroup' => esc_html__( 'Landscape orientation', 'wpforms-lite' ),
'16:9' => esc_html__( '16:9', 'wpforms-lite' ),
'5:4' => esc_html__( '5:4', 'wpforms-lite' ),
'3:2' => esc_html__( '3:2', 'wpforms-lite' ),
],
'portrait' => [
'optgroup' => esc_html__( 'Portrait orientation', 'wpforms-lite' ),
'9:16' => esc_html__( '9:16', 'wpforms-lite' ),
'4:5' => esc_html__( '4:5', 'wpforms-lite' ),
'2:3' => esc_html__( '2:3', 'wpforms-lite' ),
],
];
// Add class to hide freeform if a format is not a photo.
$camera_format = ! empty( $field['camera_format'] ) ? $field['camera_format'] : 'photo';
$aspect_ratio_class = [ 'wpforms-file-upload-camera-aspect-ratio-select' ];
if ( $camera_format !== 'photo' ) {
$aspect_ratio_class[] = 'wpforms-file-upload-camera-aspect-ratio-no-freeform';
}
$aspect_ratio_select = $this->field_element(
'select',
$field,
[
'slug' => 'camera_aspect_ratio',
'value' => ! empty( $field['camera_aspect_ratio'] ) ? $field['camera_aspect_ratio'] : 'original',
'options' => $aspect_ratio_options,
'class' => $aspect_ratio_class,
],
false
);
// Check if the camera is enabled to determine visibility.
$hidden_class = $this->is_camera_enabled_for_field( $field ) ? [] : [ 'wpforms-hidden' ];
$this->field_element(
'row',
$field,
[
'slug' => 'camera_aspect_ratio',
'content' => $aspect_ratio_label . $aspect_ratio_select,
'class' => array_merge( [ 'wpforms-file-upload-camera-aspect-ratio' ], $hidden_class ),
]
);
}
/**
* Add camera custom ratio options.
*
* @since 1.9.8
*
* @param array $field Field data and settings.
*/
private function add_camera_custom_ratio_options( array $field ): void {
// Check if an aspect ratio is custom to determine visibility.
$camera_aspect_ratio = ! empty( $field['camera_aspect_ratio'] ) ? $field['camera_aspect_ratio'] : 'original';
$custom_ratio_hidden_class = ( $this->is_camera_enabled_for_field( $field ) && $camera_aspect_ratio === 'custom' ) ? [] : [ 'wpforms-hidden' ];
// Ratio Width field.
$ratio_width_field = '<div class="wpforms-file-upload-camera-ratio-width">' . $this->field_element(
'text',
$field,
[
'slug' => 'camera_ratio_width',
'type' => 'number',
'value' => ! empty( $field['camera_ratio_width'] ) && $field['camera_ratio_width'] >= 1 ? $field['camera_ratio_width'] : '4',
'attrs' => [
'min' => 1,
'step' => 1,
],
'after' => esc_html__( 'Ratio Width', 'wpforms-lite' ),
'class' => 'wpforms-file-upload-camera-ratio-width-input',
],
false
) . '</div>';
// Ratio Height field.
$ratio_height_field = '<div class="wpforms-file-upload-camera-ratio-height">' . $this->field_element(
'text',
$field,
[
'slug' => 'camera_ratio_height',
'type' => 'number',
'value' => ! empty( $field['camera_ratio_height'] ) && $field['camera_ratio_height'] >= 1 ? $field['camera_ratio_height'] : '3',
'attrs' => [
'min' => 1,
'step' => 1,
],
'after' => esc_html__( 'Ratio Height', 'wpforms-lite' ),
'class' => 'wpforms-file-upload-camera-ratio-height-input',
],
false
) . '</div>';
$this->field_element(
'row',
$field,
[
'slug' => 'camera_custom_ratio',
'content' => '<div class="wpforms-field-option-row-columns wpforms-field-option-row-columns-2 wpforms-file-upload-camera-ratio-columns">' . $ratio_width_field . $ratio_height_field . '</div>',
'class' => array_merge( [ 'wpforms-file-upload-camera-custom-ratio' ], $custom_ratio_hidden_class ),
]
);
}
/**
* Add camera time limit options.
*
* @since 1.9.8
*
* @param array $field Field data and settings.
*/
private function add_camera_time_limit_options( array $field ): void {
$time_limit_label = $this->field_element(
'label',
$field,
[
'slug' => 'camera_time_limit',
'value' => esc_html__( 'Time Limit', 'wpforms-lite' ),
'tooltip' => esc_html__( 'Set the time limit for camera recording.', 'wpforms-lite' ),
'class' => 'wpforms-file-upload-camera-time-limit-label',
],
false
);
// Minutes field.
$minutes_field = '<div class="wpforms-file-upload-camera-time-limit-minutes">' . $this->field_element(
'text',
$field,
[
'slug' => 'camera_time_limit_minutes',
'type' => 'number',
'value' => ! empty( $field['camera_time_limit_minutes'] ) && $field['camera_time_limit_minutes'] >= 0 ? $field['camera_time_limit_minutes'] : '1',
'attrs' => [
'min' => 0,
'step' => 1,
],
'after' => esc_html__( 'Minutes', 'wpforms-lite' ),
'class' => 'wpforms-file-upload-camera-time-limit-minutes-input',
],
false
) . '</div>';
// Seconds field.
$seconds_field = '<div class="wpforms-file-upload-camera-time-limit-seconds">' . $this->field_element(
'text',
$field,
[
'slug' => 'camera_time_limit_seconds',
'type' => 'number',
'value' => ! empty( $field['camera_time_limit_seconds'] ) && $field['camera_time_limit_seconds'] >= 0 && $field['camera_time_limit_seconds'] <= 59 ? $field['camera_time_limit_seconds'] : '30',
'attrs' => [
'min' => 0,
'max' => 59,
'step' => 1,
],
'after' => esc_html__( 'Seconds', 'wpforms-lite' ),
'class' => 'wpforms-file-upload-camera-time-limit-seconds-input',
],
false
) . '</div>';
// Check if a format is video to determine time limit visibility.
$camera_format = ! empty( $field['camera_format'] ) ? $field['camera_format'] : 'photo';
$time_limit_hidden_class = ( $this->is_camera_enabled_for_field( $field ) && $camera_format === 'video' ) ? [] : [ 'wpforms-hidden' ];
$this->field_element(
'row',
$field,
[
'slug' => 'camera_time_limit',
'content' => $time_limit_label . '<div class="wpforms-field-option-row-columns wpforms-field-option-row-columns-2 wpforms-file-upload-camera-time-limit-columns">' . $minutes_field . $seconds_field . '</div>',
'class' => array_merge( [ 'wpforms-file-upload-camera-time-limit' ], $time_limit_hidden_class ),
]
);
}
/**
* Whether the provided form has a camera field.
*
* @since 1.9.8
*
* @param array|mixed $form Form data.
*/
protected function is_camera_enabled( $form ): bool {
if ( empty( $form['fields'] ) ) {
return false;
}
foreach ( $form['fields'] as $field ) {
if ( ! empty( $field['camera_enabled'] ) ) {
return true;
}
}
return false;
}
/**
* Whether the field is a camera field or has camera enabled.
*
* @since 1.9.8
*
* @param array $field Field data and settings.
*/
private function is_camera_enabled_for_field( array $field ): bool {
return $this->type === 'camera' || ! empty( $field['camera_enabled'] );
}
/**
* Get the camera time limit in seconds.
*
* @since 1.9.8
*
* @param array $field Field data.
*
* @return int Camera time limit in seconds.
*/
public function get_camera_time_limit( array $field ): int {
$field = wp_parse_args(
$field,
[
'camera_enabled' => false,
'camera_format' => '',
'camera_time_limit_minutes' => 0,
'camera_time_limit_seconds' => 0,
]
);
if ( empty( $field['camera_enabled'] ) || $field['camera_format'] !== 'video' ) {
return 0;
}
return absint( $field['camera_time_limit_minutes'] ) * 60 + absint( $field['camera_time_limit_seconds'] );
}
}