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".