GitHub - це веб-платформа для зберігання коду для контролю версій та спільної роботи над ним. Платформа дозволяє вам та іншим користувачам спільно працювати над проектами з будь-якого місця. На GitHub розміщений і підтримується код безкоштовних шаблонів (тем) для компонента JKassa.
Якщо ви використовуєте користувальницьку тему для свого веб-сайту (магазину) або розробляєте теми компонента JKassa для своїх клієнтів, то ця стаття для вас. Також, якщо ви знайшли помилку в коді теми, яку ви хочете виправити, цей матеріал також вам буде корисний.
Це коротке керівництво допоможе вам зрозуміти, як стежити за змінами, зробленими в нових випусках шаблонів (тем), та відправити код з помилкою використовуючи GitHub.
Просте відстеження змін
Якщо вам потрібно тільки перевірити, що було змінено в новому випуску (оновленні) теми JKassa, вам не потрібно реєструватися й отримувати власний аккаунт на GitHub.
Перейдіть на сторінку переліку репозиторіїв JKassa і оберіть тему, яку ви використовуєте або за кодом якої ви бажаєте простежити.
Перейдіть на вкладку "Commits".
Оберіть останню фіксацію (оновлення) в переліку.
Тут ви можете побачити опис для зроблених змін й переглянути зроблені зміни в останній версії теми або більш ранніх версіях.
Надішліть повідомлення про помилку
Якщо ви знайшли помилку або недопрацювання в коді шаблону (теми) компонента JKassa - повідомте нам про це.
- Перейдіть на сторінку переліку репозиторіїв JKassa.
- Оберіть тему, про яку ви бажаєте повідомити.
- Перейдіть на вкладку "Issues".
- Натисніть кнопку "New issues".
- Опишіть детально проблему або помилку (використовуйте код та зображення), відправте повідомлення.
Наші розробники розглянуть вашу пропозицію та дадуть відповідь вам в міру можливості.
Зробіть свій внесок
Крок 1. Отримайте свою власну копію
Спочатку, вам необхідно створити копію репозиторія для потрібної теми JKassa.
- Увійдіть в систему зі своїм обліковим записом GitHub.
- Перейдіть на сторінку переліку репозиторіїв JKassa.
- Оберіть тему, яку ви використовуєте або за якою ви бажаєте стежити.
- Переключитися на гілку "staging".
Натисніть кнопку "Fork" та дочекайтеся закінчення процесу.
Копія теми буде доступна як новий репозиторій у вашому власному обліковому запису GitHub.
Крок 2. Доступ до власного репозиторія
Моє ім'я користувача - "GeneticsTest", я вибрав тему "jkTemplatesProtostar", тому мій репозиторій доступний за адресою: github.com/GeneticsTest/jkTemplatesProtostar.
- Перейдіть до
github.com/your-github-username. - Перейдіть на вкладку "Repositories".
- Знайдіть репозиторій "jkTemplatesProtostar" - це ваша копія обраної теми.
Щоб перевірити, що ви дійсно перебуваєте в своїй копії коду теми (а не в оригіналі), дивіться інформацію зверху, де згадується: your-github-username/jkTemplatesProtostar, та нижче показано вихідне місце розташування репозиторія.
Крок 3. Відредагуйте файли та зафіксуйте зміни у вашому репозиторію
Зараз у вас є доступ до всіх папок та файлів шаблону (теми) JKassa, яку ви вибрали.
Ви можете редагувати ці файли для поліпшення коду, виправлення помилок, пропозиції нових функцій та т.д.
Мій приклад буде фіктивним, мета цього "покращення" - проілюструвати кроки, перераховані нижче.
Я переходжу до папки: css/, тому що хочу редагувати файл style.css.
Для початку редагування натисніть кнопку "Edit" - значок олівця.
Внесіть зміни у код, які, на вашу думку, покращать тему компонента.
Після того, як ви закінчите, прокрутіть вниз і натисніть кнопку "Commit changes".
Повідомлення про оновлення підтвердить, що файл, який ви змінили, був оновлений.
Крок 4. Відправити запит Pull до вихідного репозиторія
На цьому етапі ви змінили код у своїй власній копії теми. Наступним кроком буде зробити запит на перенесення, що означає відправку змін з вашої копії теми до вихідного репозиторія.
Поверніться до головного сховища JKassa: github.com/JKassa/jkTemplatesProtostar.
Натисніть на кнопку "Compare & pull request".
На наступному екрані буде відображатися важлива інформація для перевірки.
Основна гілка повинна бути "staging".
Напишіть коротку інформацію про зміни. Якщо ваші зміни направлені для вирішення існуючої проблеми зі списку проблем (Issues), введіть тут номер повідомлення. Також якщо ваші редагування стосуються питання, яке обговорювалося на форумі JKassa, залиште посилання на його пост або тему.
Натисніть кнопку "Create pull request", коли ви закінчите.
Крок 5. Зачекайте, поки ваші вклади будуть розглянуті
Розробники JKassa проведуть перевірку вашого коду, протестують його та на основі результатів, вирішать, чи варто об'єднати ваші поліпшення до майстер-гілки.
Зверніть увагу, що ваш запит буде загальнодоступним та показаний на вкладці "Pull requests".
