Autor: sharc

  • Page-Guide-Popup, czyli interaktywny przewodnik po stronie WordPress

    Niedawno opublikowałem swoją pierwszą wtyczkę do WordPressa.

    „Page Guide Popup to lekka i przyjazna dla użytkownika wtyczka, która dodaje interaktywny przewodnik pomagający odwiedzającym poruszać się po witrynie WordPress. Wyświetla się jako pływający przycisk ze znakiem zapytania, który po kliknięciu wyświetla wyskakujące okienko z linkami do ważnych stron i ich opisami.”

    Strona główna wtyczki Page-Guide-Popup dostępna na stronie https://wordpress.org/plugins/page-guide-popup/

    Mój pierwszy plugin do WordPressa

    Byłem bardzo ciekaw jak wygląda proces kontrybucji do systemu WordPressa. Najprostszym sposobem jest napisanie prostej, a przydatnej wtyczki do WordPressa, która rozszerza podstawowe funkcje tego środowiska.

    Cały proces publikacji wtyczki jest oczywiście bardzo szczegółowo opisany na stronie WordPress.org -> https://developer.wordpress.org/plugins/

    Przygotowanie dobrej wtyczki, która przejdzie pozytywną weryfikacje zespołu WP, a następnie upublicznienie jej nie jest skompilkowanym procesem, ale na pewno wymaga starannego zaznajomienia się ze standardem pisania wtyczek i zasadami zgłaszania ich do weryfikacji. Warto poświęcić trochę czasu na dokładne przeczytanie instrukcji i przejśie całego procesu, bo statysfakcja z publicznego wystawienia wtyczki i korzystania z niej jest spora :).

    Wyżej wspomniana wtyczka jest prostym przewodnikiem po stronie. Potrzebowałem takiej funkcji, a skoro przy okazji mogę dodać cegłe do otwartego ekosystemu WordPressa to nie widzę powodu, żeby tego nie zrobić.

    Dostęp do wtyczki

    Wtyczka jest dostępna do użycia na różne sposoby.

    Poprzez plugin marketplace po wpisaniu „Antoni Malinowski” lub „shapengu” 🙂

    Bezpośrednie pobranie zipa przyciskiem „Download” na wcześniej podanej stronie lub ściągnięcie kodu przez repozytorium SubVersion https://plugins.svn.wordpress.org/page-guide-popup/

    https://plugins.svn.wordpress.org/page-guide-popup/

    Chętnie przyjmę wszelkie sugestie dotyczące poprawy działania wtyczki 😉

  • Najprostszy sposób na zarządzanie wersjami Pythona

    Różne wersje Pythona mogą być potrzebne, gdy pracujesz równocześnie nad starszymi i nowymi projektami, które wymagają innych wersji języka. Jeśli nie, potraktuj to jako ciekawostkę.

    Confused Spongebob Squarepants GIF via GIPHY.com

    Pobranie narzędzia pyenv

    Standardowo instalujemy każdą wersję manualnie i ustawiamy zmienne środowiskowe wskazując na poszczególne ścieżki instalacji. Jednak łatwiejszym sposobem okazało się dla mnie użycie pyenv-win (wersja dla systemu Windows).

    Należy sklonować repozytorium githuba umieszczając je w katalogu C:/Users/[nazwa_użytkownika]

    git clone https://github.com/pyenv-win/pyenv-win.git

    Ustawienie zmiennych środowiskowych (environment variables)

    Tak, jeśli chcesz korzystać z polecenie pyenv z konsoli to trzeba dodać „environment variable” (zmienną środowiskową) dla tego narzędzia. Wystarczy to zrobić raz i potem już o tym nie myśleć.

    "PYENV" jako
    C:\Users\[nazwa_użytkownika]\.pyenv

    Zmienne PYENV_ROOT i PYENV_HOME są opcjonalne na systemie Windows – PYENV_ROOT może być przydatny dla kompatybilności z systemami Unix, ale PYENV_HOME nie jest w ogóle używany przez pyenv-win.

    "PYENV_HOME" i "PYENV_ROOT" jako
    C:\Users\[nazwa_użytkownika]\.pyenv

    Samo ustawienie zmiennej PYENV nie wystarczy, ponieważ pyenv-win wymaga również dodania ścieżek bin i shims do zmiennej PATH (lub Path), aby system Windows mógł prawidłowo przekierowywać polecenia Pythona do odpowiednich wersji.

    C:\Users\Antoni\.pyenv\pyenv-win\bin
    C:\Users\Antoni\.pyenv\pyenv-win\shims

    [PS: Teraz zamknij i otwórz ponownie wiersz poleceń]

    Użycie pyenv

    Uff, faktycznie wydaje się, że to sporo pracy. ALE teraz możemy pobrać dowolną werjsę pythona dzięki poleceniu

    pyenv install wersja_pythona

    Dzięki temu, pyenv pobiera wskazaną wersje do katalogu:

    C:\Users\[nazwa_użytkownika].pyenv\pyenv-win\versions

    a my naprawdę łatwo możemy zarządzać wersjami za pomocą

    pyenv global wersja_pythona
    lub
    python local wersja_pythona

    Polecam przeczytać w dostępnych opcjach pyenv za pomocą

    pyenv

    To wyświetli nam listę poleceń.

    „Podsumowanie” lub ostatnie akapity

    Po pierwsze, odwiedź repozytorium na githubie i sam zobacz co to za narzędzie: https://github.com/pyenv-win/pyenv-win

    Po drugie, przyznaje, że ustawienie tego za pierwszym razem było czasochłonne i nieintuicyjne.

    Równie mocno jak manualna zmiana wersji pythona, dlatego wolałem znaleźć takie narzędzie, które ogarnie to zadanie za mnie, a ja „tylko” napisze instrukcje jak w miarę prosty sposób je zainstalować.

    Jak już raz przez to przeszedłem to wydaje się być proste 😉

    Po trzecie, wspominałem, że to narzędzie otwarto-źródłowe na licencji MIT (permissive license)?

    No to jest to narzędzie…

  • Karta Praw Platform Cyfrowych

    Z wielką chęcią napisze o projektcie, w którym mam przyjemność brać udział.

    Kontekst

    Daniel Supernault (@dansup@mastodon.social), twórca sfederalizowanych platform Pixelfed i Loops, rozpoczął nowy projekt społecznościowy o nazwie RespectfulPlatforms. Projekt ma na celu „deklaracje podstawowych praw i zasad etycznych platform cyfrowych, zapewniających prywatność, godność i uczciwość w przestrzeni internetowej.

    https://respectfulplatforms.org/lang/pl/

    Inspiracja

    Tak jak to się częto dzieje w internecie, jedna osoba inspiruje drugą. Tak samo w tym przypadku inspiracją do stworzenia projektu RP był artykuł Bena WerdmulleraBuilding an open web that protects us from harm” (Budowanie otwartej sieci, która chroni nas przed krzywdą).

    https://mastodon.social/@ben@werd.social/113810546627580132

    „A co mi do tego”?

    Ktoś mógłby się spytać.

    Nie będę przekonywał do niczego. Powiem jedynie, że przeczytanie całości Karty Praw Platform Cyfrowych zajmuje 5 (pięć) minut. W dodatku jest dostępne w polsku.

    Właśnie, dlatego istnieje wpis, który czytasz – miałem okazje przetłumaczyć stronę na polski.

    Zachęcam z resztą do pomocy przy tłumaczeniu na inne języki, dodawania artykułów do kodeksu lub innych pomysłów na poprawę strony (wymagana jest podstawowa znajomość gita i konto na githubie lub znajomy, który to za Was zrobi).

    Jak się zaangażować?

    Kontrybucje do strony należy umieszczać przez https://github.com/RespectfulPlatforms/website, a również można zgłaszać swoją własną organizacje do „składania przysięgi” względem wymienionych na stronie zasad pisząc na adres pledge@pixelfed.org.

    Dla dobra otwartego, etycznego internetu i użytkowników, w tym ciebie skoro to czytasz.

?

Witam, jestem Twoim przewodnikiem. Mogę przeprowadzić Cię przez tę witrynę. Wystarczy wybrać podstronę, a ja przedstawię Ci jej opis i skieruje na nią. Jeśli nie, wystarczy kliknąć Wyjdź, a ja się zamknę ;)