Flarum eklentileri bildiğiniz gibi Composer aracılığıyla kuruluyor. Eğer aklınızda bir eklenti geliştirmek varsa, bunu nasıl yayımlayacağınız konusuna değinmek istedim.
Eklentiyi PC’de yazıp çizdiniz, testleri falan tamamladınız ve bitirdiniz diyelim. Şimdi bu projeyi Github’a ardından da Packgist’e nasıl ekleyeceğiz onu anlatacağım.
GİTHUB’TA ADIM ADIM REPO OLUŞTURMA
- İlk olarak Github’ta bir hesap oluşturup, hesabımızda oturum açalım. Karşınıza şöyle bir ekran gelecek. Sağ üst köşede varsayılan olarak gelen avatar resminize tıklayın, açılan menüde “Your Repositories” menüsüne gidelim.
- Şimdi artık repo oluşturabiliriz. Açılan ekranda “New” butonuna tıklıyoruz.
- Repomuza bir isim verelim. Zaten ilk olarak sizin Github kullanıcı adınız vardır, devamı için reponuza bir isim verin. Örneğin benim Github kullanıcı adım ekici23. Diyelim ki repoma flarum-TR adını verdim. İnsanlar bu eklentiyi kurarken
composer require ekici23/flarum-TR komutu ile kuracaklar.
“Description (optional)” kısmına eklenti hakkında bir açıklama yazabilirsiniz.
“Public ve Private” seçeneği: “Public” yaparsanız bu eklenti dünyaya açık olur. “Private” yaparsanız size özel olur.
“Add Licence” Açık kaynak kodlu olsun derseniz MIT seçin. Yok kodlar bana özel diyorsanız sizin için uygun olanı seçin.
Kaydetmek için “Create Repository” diyin.
Artık repomuz oluştu. Aşağıdaki görselde kırmızı dikdörtgen içine aldığım “Upload Files” seçeneğine tıklayıp, eklenti dosyalarını yüklüyoruz.
- Şimdi sıra geldi eklentinin versiyonunu belirtmeye. Üst menüde “releases” seçeneğine tıklıyoruz. Karşınıza aşağıdaki gibi b ir ekran gelecek.
- “Create New Releases” diyelim. Aşağıdaki ekran açılacak.
- Yukarıdaki görsele benzer şekilde istenilenleri doldurun. Burada bir püf nokta var. En altta bulunan “This is a pre-release” dediği şudur: Eklentinin beta aşamasında ise (eksikleri var, testler tamamlanmamışsa) bu seçeneği işaretleyin. Eklentiniz kararlı ise bunu boş geçip “Publish Release” diyin.
Tebrikler, Reponuzu oluşturdunuz. Sırada ne var? Şimdi sıra bu eklentimizi PHP deposuna eklemeye geldi.
PACKAGİST KURULUMU
Github’ta oluşturduğumuz repomuzu Packagist’e bağlayacağız. Bunun için öncelikle buraya tıklayarak Packagist’e üye olun.
- Packagist’e üye oldunuzu ve hesabınızda oturum açtığınızı farz ederek devam ediyorum.
- En üst menüde kullanıcı adınızın yazdığı yerin hemen yanında “submit” seçeneğine tıklıyoruz. Sizden Github URL’si girmenizi istiyor. Peki Github repomuzun URL’sini nasıl alacağız. Bunun için reponuzun adına tıklamanız yeterli. Bu anlatımdaki örnek URL’miz şöyle oldu:
https://github.com/ekici23/flarum-TR Bu URL’yi Packagist’te eklediğimizde işlem tamamlanmış olacak.
Herkese iyi forumlar.
