Práce se zdrojovým kódem a příspěvky
Stažení zdrojového kódu
nopCommerce spravuje repozitář na GitHubu (https://github.com/nopSolutions/nopCommerce). Vždy si tak můžete stáhnout nejnovější zdrojový kód! Přístup ke Git SCM (Source Code Management – správa zdrojového kódu) je veřejný a umožňuje vám v reálném čase získat nejnovější verzi nopCommerce! Můžete tak sledovat každodenní vývoj a vylepšení nopCommerce a získat nejnovější opravy bez čekání na další vydání. Pokud Git neznáte, dobrou a bezplatnou dokumentaci najdete zde. Další informace o podpoře GitHubu najdete zde. Upozorňujeme, že tyto verze by neměly být používány v produkčním prostředí. Nezaručujeme, že jakákoli funkce nebo kód z našeho SCM (správy zdrojového kódu) bude dostupný v oficiálních vydáních. Nejlepší způsob, jak získat zdrojový kód, je naklonovat repozitář. Git obsahuje vestavěné grafické nástroje pro commitování (git-gui) a procházení (gitk), ale existuje i několik nástrojů třetích stran pro uživatele, kteří hledají řešení pro konkrétní platformu. Najdete je na https://git-scm.com/downloads/guis (my používáme SourceTree).
Popis a pojmenování větví
Nedávno jsme začali používat model větvení Vincenta Driessena (viz zde: http://nvie.com/posts/a-successful-git-branching-model/) včetně používání feature větví, vývojové větve (pro integraci) a větve master (pro publikování/produkci). Dříve (do ledna 2016) jsme měli pouze větev „master“.
- Produkční větev: master
- Vývojová větev: develop
- Větve pro pracovní položky (issues): Měly by začínat slovem „issue“. Následuje ID issue (podle našeho seznamu issues na GitHubu) a nějaký srozumitelný název (například „multistore“). Výsledek by měl vypadat například takto: „issue-35-paypal-redirection-bug“
- Větve vydání: Měly by začínat slovem „release“. Následuje číslo verze (například „3.00“). Výsledek by měl vypadat takto: „release-3.00“
Vytvoření forku a odesílání pull requestů
Pokud chcete přispět zdrojovým kódem do jádra nopCommerce (oprava chyby nebo nová funkce), postupujte následovně. Zde je stručný seznam kroků pro přispění:
- Nejprve si musíte vytvořit fork. Více o vytváření forku repozitáře na GitHubu najdete na https://help.github.com/articles/fork-a-repo/.
- Naklonujte jej lokálně.
- Vytvořte novou větev z větve „develop“. Pro každý příspěvek vždy vytvořte novou větev. Vytvářejte ji pouze z naší větve „develop“. Nepoužívejte „master“.
- Napište kód a odešlete (push) jej zpět do svého forku na GitHubu.
- Vytvořte pull request. Více informací najdete na https://help.github.com/articles/using-pull-requests/. Před jeho vytvořením se prosím vždy synchronizujte s naším repozitářem.