Як встановите модуль на прикладі модуля "Додаткове поле" (редакт)
Ми розберемо установку доповнення на прикладі модуля «Додаткове поле в замовленні». Решта модулі встановлюються за аналогічною схемою.
Ви отримаєте модуль у вигляді архіву з папками. У них знаходяться файли, які потрібно буде правити, а також база даних в папці «1DB_changes».
Якщо модуль призначений для такої ж версії OkayCMS, як і у вас, і на вашому сайті немає ніяких доробок, то можна просто знайти ці ж файли і замінити.
Якщо ви встановлювали інший шаблон або якось правили стандартний, то зміни в файли, розміщені в кореневій папці «design», краще вносити вручну, а не пере файли.
Насамперед необхідно виконати sql-запит, який знаходиться в папці «1DB_changes».
- Виконуємо sql-запит.
Для цього заходимо на ваш хостинг. Переходимо в розділ «Бази даних SQL», вибираємо потрібну БД і відкриваємо phpMyAdmin.
Копіюємо вміст файлу * .sql з папки «1DB_changes» - це і буде наш запит. Для даного модуля він має вигляд:
ADD `surname` varchar (255) COLLATE 'utf8_general_ci' NOT NULL DEFAULT ''
Вставляємо запит в поле «Sql» phpMyAdmin. Після чого натискаємо кнопку «Вперед» і виконуємо.
Для редагування таких файлів нам знадобиться доступ по ФТП до вашого хостингу. На хостингу в розділі «FTP» беремо дані для підключення.
- Вносимо зміни в файли CMS.
Після підключення заходимо в папку «Api», яка знаходиться в корені сайту. Відкриваємо файл «Validate.php».
У настановних файлах модуля в однойменній теці відкриваємо такий же файл і шукаємо по документу коментар, в який виділена доопрацювання.Коментар можна дізнатися з назви папки модуля, він пишеться англійською мовою. В даному випадку код доповнення відзначений коментарем / * surname * /. Знаходимо початок і кінець коду, зазначеного коментарем, і копіюємо його.
Дивимося, де розміщений коментар, і вставляємо його в це ж місце в файл вашого сайту.
В даному файлі модуль розміщений між функцією
public function is_address ($ address = "", $ is_required = false)і функцією
public function is_comment ($ comment = "", $ is_required = false)тобто
Таким чином ми додали перевірку додаткового поля.
Аналогічно робимо з усіма файлами, які є в модулі. Знаходимо в них код, зазначений коментарем, і переносимо в відповідний файл на нашому сайті. Якщо ви точно знаєте, що цей файл у вас які раніше не редагували, то можна просто замінити його на той, який йде в архіві з модулем.
NOTICE:
Якщо файл є в папці модуля, але у вас в CMS його немає, значить, цей файл повністю новий і його потрібно просто закачати в відповідну папку вашого сайту.
Іноді в файлах доповнення трапляються закоментовані фрагменти. Так зазначається код, який ВЖЕ був в CMS, але для роботи модуля потрібно, щоб він не виконувався. У таких випадках треба знайти цей фрагмент у файлі сайту і закомментировать його, а ще краще скопіювати закоментувавши фрагмент з доповнення і вставити в соответсвтвующее місце у себе.
- Додати ляем код в кошик замовлення.
Відкриваємо папку встановленого на вашому сайті шаблону. Зазвичай вона розміщена в кореневій папці «design». Там потрібно вибрати підпапку з назвою теми вашого сайту. У дефолтного шаблону папка називається «okay_shop», у інших - має іншу назву.
Встановлювати доопрацювання потрібно в активний шаблон. Якщо ви надалі включите інший шаблон, то в ньому цих правок не буде!
У файлах шаблону доопрацювання відзначена коментарем в фігурних дужках. У нашому випадку - {* surname *}. Копіюємо все що отмеченно цим коментарем. Знаходимо в файлі шаблону місце, де повинна розміщуватись наше додаток, і вставляємо туди скопійований код.
Наприклад, в дефолтних шаблоні, доробка розміщена після
<span data-language = "form_error_captcha"> <div class = "form_group col-sm-6"> <input class = "form_input" name = "name" type = "text" value = "" data-language = "form_name" placeholder = " *"> </ div>тобто
Вставляємо код в ваш файл і зберігаємо.
В результаті у вас з'явиться додаткове поле в кошику при оформленні замовлення:
Так само поле з'являється в «Дітлахи замовлення»:
і в адмінпанелі в «замовлення»:
Сподіваємося, ми змогли зрозуміло пояснити процедуру установки модуля взагалі і «Додаткового поля» зокрема. Якщо залишилися питання, пишіть в коментарях, а тим, хто зовсім не впорається, допоможе наша техпідтримка !