Files
root b6df4dbb92 Snapshot: MLS sync fixes, image refresh, plugin/theme updates
MLS plugin fixes from this session:
- Fix silent insert failures: location column NOT NULL was rejecting wpdb->insert calls,
  causing ~18k new properties since Dec 2025 to be lost. Inserts now build raw SQL
  with ST_PointFromText so the spatial column is populated atomically.
- Auto-refresh expired media URLs in MLS_Media_Handler::fetch_and_cache(), guarded by
  a property-level GET_LOCK so concurrent fetches share one API refresh.
- Normalize WP_Error to null in mls_get_property_image() so callers can rely on the
  documented string|null contract.
- Support comma-separated property_type filters in MLS_Query and MLS_Cluster so the
  homepage "View All Commercial" link (?property_type=Commercial+Sale,Land,Farm)
  actually filters correctly.
- Incremental sync now looks back 10 minutes past the latest modification timestamp
  as a safety margin against missed records.
- Smart sync exits silently (info-level, not warning) when a full sync is in progress.

Operational:
- New cron: weekly full sync Sundays at 3 AM (/usr/local/bin/mls-full-sync).
- New cron: hourly 2GB cap on mls-thumbnails/ and cache/transformed-images/
  (/usr/local/bin/mls-image-cache-cap).
- Logrotate config for wp-content/debug.log (2-day retention, daily rotation,
  delaycompress).

Repo policy:
- CLAUDE.md updated with explicit "commit everything except build artifacts" policy.
- .gitignore: untrack runtime image caches and debug.log rotations.

Other modifications in this snapshot are pre-existing in-flight theme/plugin/db_content_updates work.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-29 15:32:23 +00:00

670 lines
19 KiB
JavaScript
Executable File

/* global wpforms_builder, wpforms_builder_stripe, WPFormsBuilderPaymentsUtils */
// noinspection ES6ConvertVarToLetConst
/**
* Stripe builder function.
*
* @since 1.8.4
*/
// eslint-disable-next-line no-var
var WPFormsStripeModernBuilder = window.WPFormsStripeModernBuilder || ( function( document, window, $ ) {
/**
* Elements holder.
*
* @since 1.8.4
*
* @type {Object}
*/
let el = {};
/**
* Public functions and properties.
*
* @since 1.8.4
*
* @type {Object}
*/
const app = {
/**
* Start the engine.
*
* @since 1.8.4
*/
init() {
$( app.ready );
},
/**
* Initialized once the DOM is fully loaded.
*
* @since 1.8.4
*/
ready() {
app.customMetadataActions();
if ( app.isLegacySettings() ) {
return;
}
// Cache DOM elements.
el = {
$alert: $( '#wpforms-stripe-credit-card-alert' ),
$panelContent: $( '#wpforms-panel-content-section-payment-stripe' ),
$feeNotice: $( '.wpforms-stripe-notice-info' ),
};
app.bindUIActions();
app.bindPlanUIActions();
if ( ! wpforms_builder_stripe.is_pro ) {
const baseSelector = '.wpforms-panel-content-section-stripe',
toggleInput = `${ baseSelector } .wpforms-panel-content-section-payment-toggle input`,
planNameInput = `${ baseSelector } .wpforms-panel-content-section-payment-plan-name input`;
$( toggleInput ).each( WPFormsBuilderPaymentsUtils.toggleContent );
$( planNameInput ).each( WPFormsBuilderPaymentsUtils.checkPlanName );
$( '#wpforms-panel-payments' )
.on( 'click', toggleInput, WPFormsBuilderPaymentsUtils.toggleContent )
.on( 'click', `${ baseSelector } .wpforms-panel-content-section-payment-plan-head-buttons-toggle`, WPFormsBuilderPaymentsUtils.togglePlan )
.on( 'click', `${ baseSelector } .wpforms-panel-content-section-payment-plan-head-buttons-delete`, WPFormsBuilderPaymentsUtils.deletePlan )
.on( 'input', planNameInput, WPFormsBuilderPaymentsUtils.renamePlan )
.on( 'focusout', planNameInput, WPFormsBuilderPaymentsUtils.checkPlanName );
}
},
/**
* Process custom metadata actions.
*
* @since 1.9.6
*/
customMetadataActions() {
$( '#wpforms-panel-payments' )
.on( 'focusout', '.wpforms-panel-field-stripe-custom-metadata-meta-key', function() {
// Remove invalid characters for meta key.
$( this ).val( $( this ).val().replace( /[^\p{L}\p{N}_-]/gu, '' ) );
} )
// Add metadata row.
.on( 'click', '.wpforms-panel-content-section-stripe-custom-metadata-add', function( e ) {
e.preventDefault();
const $table = $( this ).parents( '.wpforms-panel-content-section-stripe-custom-metadata-table' ),
$lastRow = $table.find( 'tr' ).last(),
$clone = $lastRow.clone( true ),
lastID = $lastRow.data( 'key' ),
nextID = lastID + 1;
// Update row key ID.
$clone.attr( 'data-key', nextID );
// Increment the counter.
$clone.html( $clone.html().replaceAll( '[' + lastID + ']', '[' + nextID + ']' ).replaceAll( '-' + lastID + '-', '-' + nextID + '-' ) );
// Clear values.
$clone.find( 'select, input' ).val( '' );
// Re-enable "delete" button.
$clone.find( '.wpforms-panel-content-section-stripe-custom-metadata-delete' ).removeClass( 'hidden' );
// Remove error classes.
$clone.find( '.wpforms-required-field-error' ).removeClass( 'wpforms-required-field-error' );
// Put it back to the table.
$table.find( 'tbody' ).append( $clone.get( 0 ) );
} )
// Delete metadata row.
.on( 'click', '.wpforms-panel-content-section-stripe-custom-metadata-delete', function( e ) {
e.preventDefault();
$( this ).parents( '.wpforms-panel-content-section-stripe-custom-metadata-table tr' ).remove();
} );
},
/**
* Process various events as a response to UI interactions.
*
* @since 1.8.4
*/
bindUIActions() {
const $builder = $( '#wpforms-builder' );
$builder.on( 'wpformsFieldDelete', app.disableNotifications )
.on( 'wpformsSaved', app.requiredFieldsCheck )
.on( 'wpformsFieldAdd', app.fieldAdded )
.on( 'wpformsFieldDelete', app.fieldDeleted )
.on( 'wpformsPaymentsPlanCreated', app.toggleMultiplePlansWarning )
.on( 'wpformsPaymentsPlanCreated', app.bindPlanUIActions )
.on( 'wpformsPaymentsPlanDeleted', app.toggleMultiplePlansWarning );
el.$panelContent
.find( '.wpforms-panel-content-section-payment-one-time' )
.on( 'change', '.wpforms-panel-field-stripe-custom-metadata-meta-key', app.resetCustomMetaKeyErrorClass );
},
/**
* Bind plan UI actions.
*
* @since 1.9.5
*/
bindPlanUIActions() {
el.$panelContent.find( '.wpforms-panel-content-section-payment-plan-body .wpforms-panel-field-select select[name*="email"]' ).on( 'change', app.resetEmailAlertErrorClass );
el.$panelContent.find( '.wpforms-panel-content-section-payment-plan-body .wpforms-panel-field-stripe-custom-metadata-meta-key' ).on( 'change', app.resetCustomMetaKeyErrorClass );
el.$panelContent.find( '.wpforms-panel-content-section-payment-plan-period select' ).on( 'change', app.resetCyclesValues );
},
/**
* On form save notify users about required fields.
*
* @since 1.8.4
*/
requiredFieldsCheck() {
const validationState = app.validateFields();
if ( ! validationState?.invalid ) {
return;
}
app.openAlert(
app.getAlertMessage( validationState.type ),
() => validationState.invalid.$element.focus()
);
},
/**
* Validates form fields based on their visibility and specific conditions.
*
* @since 1.9.8.3
*
* @return {Object|boolean} Returns an object representing the validation state or `true` if the panel content is hidden.
*/
validateFields() {
if ( el.$panelContent.hasClass( 'wpforms-hidden' ) ) {
return true;
}
// We want to determine which fields are not filled to display an appropriate error message.
// Also, it contains the type of the payment: one-time or recurring.
const validationState = {};
if ( $( '#wpforms-panel-field-stripe-enable_one_time' ).is( ':checked' ) ) {
app.validateOneTimeFields( validationState );
}
if ( $( '#wpforms-panel-field-stripe-enable_recurring' ).is( ':checked' ) ) {
app.validateRecurringFields( validationState );
}
return validationState;
},
/**
* Validates the one-time payment fields within the form's panel content.
*
* @since 1.9.8.3
*
* @param {Object} validationState The current validation state object.
*/
validateOneTimeFields( validationState ) {
const $oneTimeScope = el.$panelContent.find( '.wpforms-panel-content-section-payment-one-time' );
validationState.type = 'one-time';
app.validateCustomMetaTable( $oneTimeScope, validationState );
},
/**
* Validates recurring fields within the payment plan section of the panel content.
*
* @since 1.9.8.3
*
* @param {Object} validationState An object representing the current state of validation.
*/
validateRecurringFields( validationState ) {
validationState.type = validationState.type ? 'both' : 'recurring';
el.$panelContent.find( '.wpforms-panel-content-section-payment-plan' ).each( function() {
const $plan = $( this );
app.validateEmailField( $plan, validationState );
app.validateCustomMetaTable( $plan, validationState );
} );
},
/**
* Validates the email field for a given plan and updates the validation state if the field is empty.
*
* @since 1.9.8.3
*
* @param {Object} $plan jQuery object representing the plan element.
* @param {Object} validationState Object representing the validation state that will be updated.
*/
validateEmailField( $plan, validationState ) {
const planId = $plan.data( 'plan-id' );
const $emailField = $( `#wpforms-panel-field-stripe-recurring-${ planId }-email` );
if ( $emailField.val() ) {
return;
}
$emailField.addClass( 'wpforms-required-field-error' );
validationState.invalid = validationState.invalid ?? {};
validationState.invalid.email = true;
if ( ! validationState.invalid.$element ) {
validationState.invalid.$element = $emailField;
}
},
/**
* Validates the custom metadata table rows within the specified scope.
*
* @since 1.9.8.3
*
* @param {Object} $scope The jQuery object representing the current scope containing the custom metadata table.
* @param {Object} validationState The object used to store the validation state for the custom metadata rows.
*
* @return {boolean|void} Returns `true` if no rows are present for validation, otherwise no return value.
*/
validateCustomMetaTable( $scope, validationState ) {
const $customMetaRows = $scope.find( '.wpforms-panel-content-section-stripe-custom-metadata-table tr[data-key]' );
if ( ! $customMetaRows.length ) {
return true;
}
$customMetaRows.each( function() {
const $row = $( this );
if ( app.isValidCustomMetaRow( $row ) ) {
return;
}
validationState.invalid = validationState.invalid ?? {};
validationState.invalid.customMeta = true;
if ( ! validationState.invalid.$element ) {
validationState.invalid.$element = $row.find( '.wpforms-panel-field-stripe-custom-metadata-meta-key' );
}
} );
},
/**
* Validates if a custom metadata row in the form is properly filled.
*
* @since 1.9.8.3
*
* @param {Object} $row jQuery object representing the custom metadata row to validate.
*
* @return {boolean} True if the custom metadata row is valid, otherwise false.
*/
isValidCustomMetaRow( $row ) {
const $metaKey = $row.find( '.wpforms-panel-field-stripe-custom-metadata-meta-key' );
const isValid = (
! $row.find( '.wpforms-panel-field-stripe-custom-metadata-object-type' ).val() ||
! $row.find( '.wpforms-panel-field-stripe-custom-metadata-meta-value' ).val() ||
$metaKey.val()
);
$metaKey.toggleClass( 'wpforms-required-field-error', ! isValid );
return isValid;
},
/**
* Maybe reset required email field error class.
*
* @since 1.9.5
*/
resetEmailAlertErrorClass() {
$( this ).toggleClass( 'wpforms-required-field-error', ! $( this ).val() );
},
/**
* Resets the error class for a custom meta key row.
*
* @since 1.9.8.3
*/
resetCustomMetaKeyErrorClass() {
const $row = $( this ).closest( 'tr[data-key]' );
app.isValidCustomMetaRow( $row );
},
/**
* Show alert for required recurring email field.
*
* @since 1.8.4
* @deprecated 1.9.8.3
*/
recurringEmailAlert() {
// eslint-disable-next-line no-console
console.warn( 'WARNING! Function "WPFormsStripeModernBuilder.recurringEmailAlert()" has been deprecated, please use the "WPFormsStripeModernBuilder.openAlert()" function instead!' );
app.openAlert( wpforms_builder.stripe_recurring_email );
},
/**
* Opens an alert dialog with a customized message and optional callback action.
*
* @since 1.9.8.3
*
* @param {string} alertMessage The message to be displayed in the alert dialog.
* @param {Function} onClose Optional callback function to execute when the alert is closed.
*/
openAlert( alertMessage, onClose = () => {} ) {
$.alert( {
title: wpforms_builder.stripe_recurring_heading,
content: alertMessage,
icon: 'fa fa-exclamation-circle',
type: 'red',
buttons: {
confirm: {
text: wpforms_builder.ok,
btnClass: 'btn-confirm',
keys: [ 'enter' ],
action: onClose,
},
},
onOpen() {
$( '.wpforms-stripe-settings-redirect' ).on( 'click', app.settingsRedirect );
},
} );
},
/**
* Returns an alert message based on the specified payment type and Stripe visibility settings.
*
* @since 1.9.8.3
*
* @param {string} paymentType The payment type (e.g., 'one-time', 'recurring', or 'both') used to determine the alert message.
*
* @return {string} The appropriate alert message for the specified payment type.
*/
getAlertMessage( paymentType ) {
if ( ! $( '.wpforms-panel-content-section-stripe' ).is( ':visible' ) ) {
return wpforms_builder.stripe_recurring_settings;
}
const typesMap = {
'one-time': 'stripe_required_one_time_fields',
recurring: 'stripe_required_recurring_fields',
both: 'stripe_required_both_fields',
};
return wpforms_builder[ typesMap[ paymentType ] ?? typesMap.recurring ];
},
/**
* Redirect to the settings tab.
*
* @since 1.9.5
*/
settingsRedirect() {
// Open the Stripe settings tab.
$( '.wpforms-panel-payments-button' ).trigger( 'click' );
$( '.wpforms-panel-sidebar-section-stripe' ).trigger( 'click' );
// Scroll to the Stripe settings.
window.location.href = window.location.pathname + window.location.search + '#wpforms-panel-field-stripe-enable_recurring-wrap';
// Close the alert.
$( this ).closest( '.jconfirm-box' ).find( '.btn-confirm' ).trigger( 'click' );
},
/**
* Disable notifications.
*
* @since 1.8.4
*
* @param {Object} e Event object.
* @param {number} id Field ID.
* @param {string} type Field type.
*/
disableNotifications( e, id, type ) {
if ( ! app.isStripeField( type ) ) {
return;
}
if ( app.hasStripeCreditCardFieldInBuilder() ) {
return;
}
const $notificationWrap = $( '.wpforms-panel-content-section-notifications [id*="-stripe-wrap"]' );
$notificationWrap.find( 'input[id*="-stripe"]' ).prop( 'checked', false );
$notificationWrap.addClass( 'wpforms-hidden' );
},
/**
* Determine is legacy settings is loaded.
*
* @since 1.8.4
*
* @return {boolean} True is legacy settings loaded.
*/
isLegacySettings() {
return $( '#wpforms-panel-field-stripe-enable' ).length;
},
/**
* We have to do several actions when the "Stripe" field is added.
*
* @since 1.8.4
*
* @param {Object} e Event object.
* @param {number} id Field ID.
* @param {string} type Field type.
*/
fieldAdded( e, id, type ) {
if ( ! app.isStripeField( type ) ) {
return;
}
if ( ! app.hasStripeCreditCardFieldInBuilder() ) {
return;
}
app.settingsToggle( true );
el.$feeNotice.toggleClass( 'wpforms-hidden' );
},
/**
* We have to do several actions when the "Stripe" field is deleted.
*
* @since 1.8.4
*
* @param {Object} e Event object.
* @param {number} id Field ID.
* @param {string} type Field type.
*/
fieldDeleted( e, id, type ) {
if ( ! app.isStripeField( type ) ) {
return;
}
if ( app.hasStripeCreditCardFieldInBuilder() ) {
return;
}
app.settingsToggle( false );
app.disablePayments();
el.$feeNotice.toggleClass( 'wpforms-hidden' );
},
/**
* Determine if a field type is Stripe credit card.
*
* @since 1.8.4
*
* @param {string} type Field type.
*
* @return {boolean} True if Stripe field.
*/
isStripeField( type ) {
return type === wpforms_builder_stripe.field_slug;
},
/**
* Checks if the Stripe Credit Card field is in the form builder.
*
* @since 1.9.5
*
* @return {boolean} True if the Stripe Credit Card field is in the builder.
*/
hasStripeCreditCardFieldInBuilder() {
return $( `.wpforms-field.wpforms-field-${ wpforms_builder_stripe.field_slug }` ).length > 0;
},
/**
* Toggles visibility of multiple plans warning.
*
* @since 1.8.4
*/
toggleMultiplePlansWarning() {
el.$panelContent.find( '.wpforms-stripe-multiple-plans-warning' ).toggleClass( 'wpforms-hidden', el.$panelContent.find( '.wpforms-panel-content-section-payment-plan' ).length === 1 );
},
/**
* Toggles visibility of the Stripe addon settings.
*
* @since 1.8.4
*
* @param {boolean} display Show or hide settings.
*/
settingsToggle( display ) {
if (
! el.$alert.length &&
! el.$panelContent.length
) {
return;
}
el.$alert.toggleClass( 'wpforms-hidden', display );
el.$panelContent.toggleClass( 'wpforms-hidden', ! display );
},
/**
* Toggle payments content.
*
* @since 1.8.4
*/
toggleContent() {
// eslint-disable-next-line no-console
console.warn( 'WARNING! Function "WPFormsStripeModernBuilder.toggleContent()" has been deprecated, please use the new "WPFormsPaymentsUtils.toggleContent()" function instead!' );
WPFormsBuilderPaymentsUtils.toggleContent();
},
/**
* Toggle a plan content.
*
* @since 1.8.4
*/
togglePlan() {
// eslint-disable-next-line no-console
console.warn( 'WARNING! Function "WPFormsStripeModernBuilder.togglePlan()" has been deprecated, please use the new "WPFormsPaymentsUtils.togglePlan()" function instead!' );
WPFormsBuilderPaymentsUtils.togglePlan();
},
/**
* Delete a plan.
*
* @since 1.8.4
*/
deletePlan() {
// eslint-disable-next-line no-console
console.warn( 'WARNING! Function "WPFormsStripeModernBuilder.checkPlanName()" has been deprecated, please use the new "WPFormsPaymentsUtils.deletePlan()" function instead!' );
WPFormsBuilderPaymentsUtils.deletePlan();
},
/**
* Check a plan name on empty value.
*
* @since 1.8.4
*/
checkPlanName() {
// eslint-disable-next-line no-console
console.warn( 'WARNING! Function "WPFormsStripeModernBuilder.checkPlanName()" has been deprecated, please use the new "WPFormsPaymentsUtils.checkPlanName()" function instead!' );
WPFormsBuilderPaymentsUtils.checkPlanName();
},
/**
* Rename a plan.
*
* @since 1.8.4
*/
renamePlan() {
// eslint-disable-next-line no-console
console.warn( 'WARNING! Function "WPFormsStripeModernBuilder.renamePlan()" has been deprecated, please use the new "WPFormsPaymentsUtils.renamePlan()" function instead!' );
WPFormsBuilderPaymentsUtils.renamePlan();
},
/**
* Make sure that "One-Time Payments" and "Recurring Payments" toggles are turned off.
*
* @since 1.9.5
*/
disablePayments() {
const toggleInput = $( '#wpforms-panel-field-stripe-enable_one_time, #wpforms-panel-field-stripe-enable_recurring' );
toggleInput.prop( 'checked', false ).trigger( 'change' ).each( WPFormsBuilderPaymentsUtils.toggleContent );
},
/**
* Reset cycles dropdown values based on the period selection.
*
* @since 1.9.8
*/
resetCyclesValues() {
const $el = $( this ),
$select = $el.closest( '.wpforms-panel-content-section-payment-plan-body' ).find( '.wpforms-panel-content-section-payment-plan-cycles select' ),
selectedValue = $select.val(); // Save current selected value
let max;
// Determine the maximum number of cycles based on the selected period.
// It has intentionally not been passed from PHP to avoid unnecessary complexity or unexpected behavior.
switch ( $el.val() ) {
case 'yearly':
max = 20;
break;
case 'semiyearly':
max = 40;
break;
case 'quarterly':
max = 80;
break;
default:
max = wpforms_builder_stripe.cycles_max;
}
const options = [
$( '<option>', { value: 'unlimited', text: wpforms_builder_stripe.i18n.cycles_default } ),
];
for ( let i = 1; i <= max; i++ ) {
options.push( $( '<option>', { value: i, text: i } ) );
}
// Populate select and re-apply selected value if still valid
$select.empty().append( options ).val( selectedValue );
// If selected value is no longer valid, default to 'unlimited'
if ( $select.val() !== selectedValue ) {
$select.val( 'unlimited' );
}
},
};
// Provide access to public functions/properties.
return app;
}( document, window, jQuery ) );
// Initialize.
WPFormsStripeModernBuilder.init();