README

AJAX-форма компонент для Bitrix CMS с валидацией и отправкой данных.

Documentation

For detailed documentation, see the docs folder:

• Documentation Index - Overview and navigation
• JavaScript API - Complete JavaScript API reference
• PHP API - Complete PHP API reference
• Examples - Common usage scenarios

Quick Start

Installation

1. Copy the local/components/aidsoul/forms folder to your project
2. Copy the src folder to /local/php_interface/ or configure autoload

Component Call

$APPLICATION->IncludeComponent(
 "aidsoul:forms", 
 ".default",
 array(
 "AJAX" => "Y",
 "FORM_NAME" => "contact",
 "FORM_ID" => "contact-form",
 "TITLE" => "Связаться с нами",
 "SUBMIT_TEXT" => "Отправить заявку"
 )
);

JavaScript AJAX (without BX.ajax)

// Using vanilla JavaScript Ajax class
new Ajax({
 url: '/api/endpoint',
 method: 'POST',
 data: { name: 'John' },
 success: function(data) { console.log(data); }
}).execute();

// Or using static helpers
Ajax.post('/api/submit', { name: 'John' })
 .then(function(data) { console.log(data); });

Features

• AJAX form submission without page reload
• Server-side validation
• File uploads
• CSRF protection
• Flexible field configuration
• Email event support
• Custom validation methods
• Error message localization
• Vanilla JavaScript AJAX class without BX.ajax dependency