Инсталиране и настройка - Callme 2
Откъде да започна, имейл, SMTP и sms настройки
Настройки на формуляра
Настройки на сървъра
Откъде да започна
Първи стъпки
Процесът на инсталиране е много прост, трябва да направите следното:
- Изтеглете и разархивирайте вашето копие на Callme
- Купете лиценз (по избор)
- Редактирайте конфигурационния файл, за да получите задължителните полета във вашия формуляр
- Настройте имейл и SMS известия
- Качване на файлове през FTP
- Актуализирайте шаблона на уебсайта си
Всичко е готово, наслаждавайте се! 🎉
Вграден формуляр
Можете също да обработвате всеки формуляр, вграден в страница. За да направите това, създайте обикновен формуляр и му дайте атрибута data-callme-form, бутонът за изпращане трябва да изпрати формуляра:
Добавете атрибута към полетата, необходими за обработка: data-required="true" .
Уверете се, че всички полета, от които се нуждаете, имат атрибут за име. Използва се за имена на полета в уведомления за скриптове.
Резултатът от обработката на формата може да бъде показан във всеки елемент във формата. Това може да са грешки, процес на подаване или съобщение за успешно подаване.
За да може скриптът автоматично да отразява резултатите от работата, създайте елемент във формуляра с атрибута data-callme-result.
Добавете този ред към вашия шаблон, след като настроите и добавите всички файлове към сайта:
Ако използвате папка, различна от /callme, актуализирайте връзката:
Важно е да го добавите към файл, който е на всички страници, като долен или горен колонтитул.
jQuery библиотека
Callme работи с jQuery, така че също трябва да бъде инсталиран:
В повечето случаи тази библиотека вече е инсталирана, ако не - изтеглете тук.
Предизвикателстваформи
За да направите това, просто добавете атрибута на клас data-callme-config='__config__' към елемента. Ако не посочите стойност на атрибут, ще се използва "основният" конфигурационен файл.
Заменете __config__ с точното име на вашия конфигурационен файл (с изключение на '.js').
В по-старите версии е възможно да се използва клас вместо data-attribute: . Все още можете да използвате клас, но data-attr е за предпочитане.
събития
Когато нещо се случи с някой от вашите Callme формуляри, съответното събитие се задейства на $('window') jQuery обекта.
Можете да обвържете всякакви действия с тях. Например Google Analytics.
Синтаксис на EcmaScript6:Синтаксис на EcmaScript5/JS:
Списък на събитията
| callme.load.finish | Събитието се задейства, когато се заредят настройките за callme |
| callme.close.start | Събитието се задейства, когато формулярът се затвори. |
| callme.close.finish | Събитието се задейства, когато формулярът се затвори. |
| callme.show.start | Събитието се задейства, когато се появи формулярът |
| callme.show.finish | Събитието се задейства, когато формулярът свърши да се показва |
| callme.request.finish | Събитието се задейства, когато заявката бъде изпълнена |
| callme.request.fail | Събитието се задейства, когато заявката е неуспешна. |
| callme.captcha.error | Събитие, задействано, когато captcha е въведена неправилно при изпращане на формуляр |
| callme.submit.start | Събитието се задейства, когато се щракне върху бутона за изпращане на формуляра |
| callme.submit.fail | Събитието се задейства, когато изпращането на формуляра е неуспешно. |
| callme.submit.finish | Събитието се задейства, когато формулярът е изпратен успешно |
| callme.formCreate.finish | Събитието се задейства при създаване на нов формуляр |
Маркери за връзки
Пример за настройки
Обяснение на настройките
| бутон | Настройки на плаващ бутон | [обект] |
| полета | Списък с полета, които ще бъдат показани в текущата форма | [масив] |
| форма | Настройки на формата: стил, текстови съвети, позициониране | [обект] |
| сигнали | Текстови съвети, които да се показват в известията (успех, грешка или изпращане в ход) | [обект] |
| captcha | Настройки на кода за потвърждение: видими или не и съобщение за грешка | [обект] |
| Разрешително | След като закупите лиценз, можете да разширите функционалността на скрипта и да премахнете авторските права, ако желаете. Моля, обърнете внимание, че лицензионният ключ е обвързан с домейн и трябва да се добавя към всеки конфигурационен файл. В повечето случаи ще имате един конфигурационен файл. | [обект] |
| поща | Настройки за предупреждение по имейл. Тук можете да редактирате текста на известието, което се изпраща по имейл. | [обект] |
| анимацияСкорост | Скоростта на анимацията на формата е зададена в микросекунди. Тези. 1 секунда = 1000 микросекунди. | [номер] |
Настройки на плаващ бутон.
| шоу | Показване или скриване на плаващия бутон от дясната страна (true/false) | [булева стойност] |
| текст | Подпис на бутон. Например,„Поискайте обаждане“ или „Моля, свържете се с мен“. | [низ] |
Масив от обекти за полетата, които ще се появят във формуляра. Callme работи с типовете полета, описани по-долу.
Класическо текстово поле. Аргументи:
тип текст име низ заместител низ изисква булев sms булев
Полето за Email, когато е попълнено, се проверява за валидност. Аргументи:
тип име на имейл низ заместител низ задължителен булев sms булев
Телефонен номер с маска за въвеждане. Аргументи:
въведете име на телефон низ маска текстова маска за полето, например "(999) 999-9999" задължително логическо sms логическо
Текстова област (Textarea), аргументи:
тип текстово поле име низ заместител низ необходим булев sms булев
Падащ списък. "опции" трябва да съдържа масив от възможни избори.
тип изберете име низ опции масив sms булев
отметка. Ако зададете „задължително“, формулярът Callme няма да бъде изпратен, докато не бъде поставена отметка в квадратчето.
тип квадратче за отметка име низ надпис низ (текстът да се показва до квадратчето за отметка, HTML е разрешен) задължително логическо sms логическо
| шаблон | Избор на шаблон на формуляр. Например „fb“ или „default“ | [низ] |
| заглавие | Заглавие на формуляра, като например „Заявка за обаждане“ | [низ] |
| бутон | Надпис на бутона, напр. „Обади ми се“ | [низ] |
| подравнете | Можете да изберете да показвате формата: в центъра на екрана, отляво или отдясно. За да направите това, използвайте стойностите: ляво или дясно | [низ] |
| добре дошли | Поздравителен текст, по подразбиране е „Попълнете товаформа и ние ще ви се обадим възможно най-скоро" | [низ] |
Сигнали
Текстовете, които посетителят ще види при работа с формата.
| да | Да (да, si, so, ja и т.н.) | [низ] |
| не | Не | [низ] |
| процес | Текстовият подпис, показан при изпращане на заявката. Например „Изпращам заявка.“ | [низ] |
| успех | Известие за успешно изпращане. Например „Вашата заявка беше изпратена успешно“ | [низ] |
| не успява | Възможни причини за отмяна на заявка | [обект] |
Сигнали → неуспешно
Възможни причини за отмяна на заявката. Моля, имайте предвид, че ако не зададете нито едно поле като задължително, всички полета ще бъдат задължителни по подразбиране.
| изисква се | Ако не са попълнени всички задължителни полета. Например „Моля, попълнете задължителните полета“ | [низ] |
| изпратено | Формулярът не може да бъде изпратен, ако предишната заявка от този посетител е била преди по-малко от минута. Например "Предишното съобщение беше изпратено преди по-малко от минута." | [низ] |
Ако използвате лицензиран скрипт, можете да използвате кода за потвърждение, за да подобрите сигурността на формуляра. Тази функция не е налична в безплатната версия.
| шоу | Показване на кода за потвърждение? вярно невярно | [булева стойност] |
| заглавие | Текст преди captcha. Например „Captcha“ или „Въведете код“ | [низ] |
| грешка | Грешка при въвеждане на Captcha. Например,"Грешен код" | [низ] |
Тук можете да добавите лицензен ключ. Ключът е уникален за домейна и е невъзможно да използвате вашия ключ на друг сайт. Ако имате няколко формуляра, трябва да добавите ключа към всички файлове с настройки.
| ключ | Ключът се получава след закупуване на лиценза. | [низ] |
| шоу | Показване на авторските права на формуляра? Ще бъдем благодарни, ако подкрепите нашия скрипт и не премахвате авторските права. | [булева стойност] |
Настройки на пощата. Имена на полета в имейл известия.
| анимацияСкорост | Скорост на анимацията на формата. Например 150. | [цяло число] |
Настройка на пощата
Настройките на пощата могат да се променят в php/go.php. Има две опции за работа с известия по пощата: SMTP и PHP функцията mail().
PHP изпраща имейли много по-бързо, но SMTP е по-надежден и почти гарантира, че имейлите няма да попаднат в спам.
Ако искате да промените стила на показване на вашите известия, можете да се задълбочите в променливата $message
| $до |
$to = 'вашата поща@gmail.com';
$from_user = вярно;
Избор на получател на съобщение
Можете да позволите на потребителя да избере получател, който да получи неговото съобщение. Например, това може да са различни отдели в зависимост от избраната опция.
Тази настройка се извършва в две стъпки:
SMTP настройки
SMTP настройките са във файла php/smtp.php
Моля, обърнете внимание, че този файл се игнорира, докато не го направитезадайте mail -> smtp на true във вашия конфигурационен файл.
| $config['smtp_username'] | SMTP потребителско име | [низ] |
| $config['smtp_port'] | SMTP порт | [цяло число] |
| $config['smtp_host'] | SMTP сървър. Вижте примера по-долу | [низ] |
| $config['smtp_password'] | Вашата SMTP парола | [низ] |
| $config['smtp_charset'] | Кодиране на съобщенията, най-често 'utf-8' | [низ] |
| $config['smtp_from'] | Име на изпращача, по подразбиране Callme . | [низ] |
Настройки на Gmail
Ако използвате Gmail (надяваме се, че използвате), ще трябва да включите потвърждаването в две стъпки и да генерирате парола за приложение. Това е лесно да се направи, просто следвайте инструкциите:
Паролата, която генерирате, ще бъде използвана за Callme.
SMTP сървър
Gmail smtp.gmail.com Yahoo smtp.mail.yahoo.com Yandex ssl://smtp.yandex.ru
Портове, използвани за повечето сървъри:
Gmail 25, 465 и 587 Yahoo 465 и 587 Yandex 465
Настройка на SMTP
Подробна документация е тук:
Настройки на SMS
Настройките за SMS се намират в php/sms.php
Можете да изберете кое от полетата да се изпрати на SMS и кое не. Вижте настройките на полето във вашите конфигурационни файлове за пример.
Да, някои връзки към услугата за SMS съдържат код за препоръка и на теория мога да направя малка печалба от 5-10% от разходите ви за SMS.
Работите ли с SMS-услуги на добри цени и с възможност за изпращане до повечето страни? Свържете се с мен, за да добавите вашата услуга къмсписък.
Настройките на SMS се съхраняват в sms, обект със следните настройки: