Dodaj swoje rozszerzenie

Fundamenty Publii są już w pełni gotowe i stabilne. Teraz chcemy rozbudować bibliotekę motywów i wtyczek o rozszerzenia tworzone przez naszą społeczność.

Jeśli masz własną wtyczkę lub motyw do Publii, które mogą przydać się innym użytkownikom, możesz zgłosić je do Publii Marketplace. Oto jak to zrobić:

1. Przygotuj stronę ze szczegółowym opisem wtyczki lub motywu i możliwością pobrania rozszerzenia. Może to być Twoja własna witryna lub repozytorium na GitHubie.
2. Prześlij wtyczkę lub motyw do oceny. Dołącz opis i co najmniej jeden zrzut ekranu. W przypadku wtyczki dodaj również listę funkcji oraz ikonę, która będzie widoczna w katalogu wtyczek.
3. Nasz zespół sprawdzi wtyczkę lub motyw pod kątem przyjętych kryteriów jakości.
4. Po zaakceptowaniu zgłoszenia dodamy do Publii Marketplace stronę z opisem rozszerzenia oraz linkiem do wskazanej przez Ciebie strony rozszerzenia.

Autorstwo i odpowiedzialność za utrzymanie rozszerzenia

Każda wtyczka i każdy motyw zgłaszany do Marketplace muszą mieć wskazanego autora - programistę lub zespół, który bierze odpowiedzialność za rozszerzenie. Nie przyjmujemy rozszerzeń, których wskazanym autorem jest autonomiczny agent AI odpowiedzialny za ich tworzenie, generowanie lub utrzymanie. Możesz korzystać z narzędzi AI w swojej pracy programistycznej. Ważne, aby za kod odpowiadał człowiek, z którym można skontaktować się w sprawie pomocy i który zadba o działanie rozszerzenia w kolejnych wersjach Publii.

Wymagania dotyczące zgłaszania wtyczek

Zgłoszenie wtyczki wymaga czterech elementów: strony pobierania, zrzutu ekranu, ikony oraz opisu z listą funkcji. Poniżej znajdziesz wymagania dotyczące każdego z nich:

• Strona pobierania - Twoja własna witryna, repozytorium na GitHubie lub podobna strona, z której użytkownicy będą mogli pobrać wtyczkę.
• Zrzuty ekranu - Przygotuj zrzuty wysokiej jakości w formacie .png (minimum 144 dpi). Wymagamy co najmniej jednego zrzutu ekranu ustawień, aby zachować spójny sposób prezentacji wtyczek Publii. Jeśli jednak wtyczka dodaje do strony elementy wizualne lub efekty, zamiast ekranu ustawień pokaż ją w działaniu.
• Ikona - Będzie prezentować wtyczkę na liście w Publii Marketplace.
• Opis z listą funkcji - Zachowaj format stosowany przez pozostałe wtyczki w Marketplace: krótki, jednoakapitowy opis przeznaczenia i działania wtyczki oraz krótką, listę dostępnych funkcji i opcji.

Dodatkowe wymagania techniczne dotyczące wtyczek

Aby zapewnić spójne działanie w różnych instalacjach i możliwość pracy offline, zgłaszane wtyczki muszą spełniać następujące wymagania:

• Brak zewnętrznych zależności pobieranych podczas działania - Wtyczki nie mogą korzystać z zewnętrznych sieci CDN ani dostawców zasobów, takich jak jsDelivr, unpkg czy Google Fonts. Wszystkie wymagane pliki JavaScript, CSS i fonty umieść lokalnie w katalogu wtyczki.
• Bez słowa „Publii” w nazwie wtyczki - Nazwa wtyczki nie może zawierać słowa „Publii”, aby nie sugerować, że jest to oficjalna wtyczka naszego zespołu. Wybierz ogólną nazwę opisującą jej przeznaczenie.

Wymagania dotyczące zgłaszania motywów

Zgłoszenie motywu do Marketplace wymaga podobnych materiałów jak zgłoszenie wtyczki, z kilkoma różnicami. Przygotuj stronę pobierania, działającą wersję demonstracyjną, zrzut ekranu oraz opis. Oto szczegółowe wymagania:

• Strona pobierania - Podobnie jak w przypadku wtyczek może to być Twoja własna witryna, repozytorium na GitHubie lub podobna strona, z której użytkownicy będą mogli pobrać plik motywu.
• Działająca wersja demonstracyjna - Dołącz link do wersji demonstracyjnej online, abyśmy mogli sprawdzić motyw w działaniu.
• Zrzut ekranu - Przygotuj zrzut wysokiej jakości w formacie .png (minimum 144 dpi). Zwykle powinien przedstawiać główne elementy strony głównej, takie jak nagłówek i lista wpisów, jeśli występuje w motywie. Zrzut ma pokazać najważniejsze cechy jego wyglądu.
• Opis - W jednym lub dwóch akapitach przedstaw funkcje i wygląd motywu oraz określ, dla kogo jest przeznaczony. Możesz na przykład wskazać, że sprawdzi się jako portfolio lub osobisty blog.

Dodatkowe wymagania techniczne dotyczące motywów

Zgłaszane motywy powinny również spełniać następujące wymagania:

• Wszystkie zasoby przechowywane lokalnie - Pliki JavaScript, CSS i fonty używane przez motyw muszą znajdować się w jego katalogu lub podkatalogach. Korzystanie z zasobów zewnętrznych sieci CDN jest niedozwolone.
• Bez słowa „Publii” w nazwie motywu - Aby nie sugerować, że jest to oficjalny motyw naszego zespołu, jego nazwa nie powinna zawierać słowa „Publii”. Wybierz pomysłową lub opisową nazwę, która oddaje przeznaczenie albo styl motywu.

Ocena zgłoszeń

Przy ocenie wtyczek zwracamy uwagę przede wszystkim na ich funkcjonalność i łatwość obsługi. Czy wtyczka oferuje funkcję przydatną naszym użytkownikom? Czy dostępne opcje są wystarczająco dobrze opisane? Czy wtyczka spełnia standardy wyznaczone przez oficjalne wtyczki naszego zespołu?

W przypadku motywów skupiamy się przede wszystkim na układzie i wyglądzie, dostępnych funkcjach oraz wydajności kodu, tak aby motyw w jak najmniejszym stopniu obciążał korzystające z niego strony.

W ramach oceny sprawdzimy działającą wersję demonstracyjną. Niedziałające linki, niesprawne elementy interaktywne lub niedopracowane, prowizoryczne demo są podstawą do odrzucenia zgłoszenia, niezależnie od jakości samego kodu.

W przypadku odrzucenia zgłoszenia postaramy się podać ogólny powód decyzji. Ze względu na liczbę zgłoszeń nie prowadzimy jednak szczegółowego audytu kodu ani indywidualnych konsultacji technicznych

Płatne wtyczki i motywy

Do Publii Marketplace możesz również zgłaszać płatne wtyczki i motywy. Marketplace będzie jednak wyłącznie prezentować rozszerzenie i kierować użytkowników na Twoją stronę, gdzie będą mogli je kupić. Obsługa płatności, wystawianie faktur, wsparcie po zakupie i pozostałe obowiązki związane ze sprzedażą należą do autora wtyczki lub motywu. Publii nie zapewnia wsparcia w tym zakresie.

Po zaakceptowaniu zgłoszenia

Po zaakceptowaniu zgłoszenia powiadomimy Cię i dodamy wtyczkę lub motyw do odpowiedniej kategorii Publii Marketplace. Wtyczkę będzie reprezentować przesłana ikona, a na jej stronie znajdą się zrzut ekranu, krótki opis i lista funkcji.

Motyw będzie prezentowany w katalogu za pomocą zrzutu ekranu. Na podstronie motywu znajdzie się przesłany zrzut ekranu oraz krótki opis.

Dodatkowe zrzuty ekranu, informacje o funkcjach i szczegółowy opis rozszerzenia umieść na stronie motywu lub wtyczki w swojej witrynie.

Wsparcie dla wtyczek i motywów zgłoszonych przez użytkowników

Jesteśmy niewielkim zespołem, dlatego nie możemy zapewniać wsparcia użytkownikom wtyczek i motywów zgłaszanych przez zewnętrznych autorów. Każdy autor odpowiada za rozwiązywanie problemów ze swoim rozszerzeniem i udzielanie odpowiedzi na pytania użytkowników.

Podsumowanie

W ten sposób chcemy poszerzać możliwości Publii, zachowując standard jakości, dzięki któremu pozostanie on przystępnym narzędziem dla wszystkich użytkowników, szczególnie osób z mniejszym doświadczeniem w tworzeniu stron internetowych.

Wyślij zgłoszenie rozszerzenia na adres: contact [@] getpublii.com