<!-- TITLE: Simple Blog - Dokumentacja modułu Magento 2 --> <!-- SUBTITLE: Autor: Marek Milewski --> # Moduł Simple Blog ## Opis modułu Opowiadaj historie, które pozwolą zamienić odwiedzających na Twoich nowych klientów. Moduł Simple Blog pozwoli na stworzenie szerokiej bazy blogowej, co zwiększa szansę zaangażowania przez twoich odwiedzających, w końcu sama strona produktu jest mniej atrakcyjna, niż interesujący post z chwytliwym tytułem. Nowe materiały na Twojej stronie mogą zwiększyć SEO; ktoś może zainteresować się twoim postem i dodać link do niego na własnej stronie. Regularność w tworzeniu postów daje znać dla Twoich klientów, że strona jest uaktualniana. Dziel posty na kategorie, zwiększając przejrzystość blogu. ## Zgodność modułu Ten moduł jest zgodny z następującymi wersjami Magento Community: **2.2**, **2.3**, **2.4**. ## Sposób działania Po instalacji modułu, aby dodać pierwszą kategorie, kieruj się do Panelu Admina. Tam przejdź do **Content > Blog Category**. Klikając przycisk **Add New Category** przejdziesz do formularza dodawania kategorii.  Formularz składa się z dwóch sekcji: **Category Details**, **Category SEO**.  **Name** – ustaw nazwę dla kategorii **Url** – przypisz własny url dla kategorii **Store View** – sklep/widok sklepu w którym dostępna będzie kategoria **Enable category** - włącz lub wyłącz widoczność kategorii **Sort** – pozwala na organizację kategorii  **Meta Title** – ustaw własny meta tytuł **Meta Description** – stwórz własny meta opis **Meta Keywords** - dodaj słowa kluczowe Dodana kategoria zostanie umieszczona w tabeli znajdującej się w **Content > Blog Category**.  Aby dodać post do nowo utworzonej kategorii kieruj się do **Content > Blog Posts**. Przejdź do formularza poprzez przycisk **Add New Post**.  Na stronie add new post znajdziesz trzy sekcje: **Post Details**, **Post SEO**, **Related Products**.   **Enable post** – włącz lub wyłącz widoczność postu **Title** - stwórz własny tytuł **Url** – ustaw własną ścieżkę URL dla postu **Main** Image – dodaj zdjęcie do postu (opcjonalne) **Short** Description – wpisz opis, możesz skorzystać z edytora html lub WSWIG **Content** – wpisz zawartość postu, możesz skorzystać z edytora html lub WSWIG **Category** – przypisz post do jednej lub wielu kategorii, w których ma być wyświetlany  **Meta Title** – ustaw własny meta tytuł **Meta Description** – stwórz własny meta opis **Meta Keywords** - dodaj słowa kluczowe Sekcja **Assign products in post** pozwala na przypisanie produktów, które będą wyświetlane pod postem.  W ten sam sposób można przypisać post do produktu w **Display post in products** aby wyświetlić powiązany post w karcie produktu Sekcja **Related product** pozwala na przypisanie produktów, które będą wyświetlane pod postem.  Dodane posty będą widoczne w tabeli **Content > Blog Posts**. Aby dodać większą swobodę w zarządzaniu blogiem, dodaliśmy opcję ograniczania postów w kategoriach **default** oraz **specific**. Dla wspomnianej konfiguracji kieruj się do **Stores > Configuration > Simpleblog > Blog configuration**.  Zawartość modułu Simple Blog jest zlokalizowana pod adresem “homepage/blog”. Możesz przenieść się na wspomniany adres z każdej strony sklepu, która posiada panel boczny.  Strona blogu zawiera kategorie wypisane po lewej stronie w panelu, oraz główną zawartość na środku. Klikając na **post title** lub **Read Post** zostaniesz przekierowany do postu z pełną zawartością.  ## Demo demo1.magecreation.com ## Instalacja modułu ### Instalacja przez Composer 1. Dodaj repozytorium do pliku composer.json: ```text "repositories": [ ... { "type": "vcs", "url": "git@git.auroracreation.com:aurora-modules/simple-blog.git" } ... ], ``` 2. Zmodyfikuj plik composer.json: ```text "require": { ... "aurora/simpleblog": "*" ... }, ``` 3. W folderze głównym Magento wykonaj następujące polecenia: ```text composer update aurora/simpleblog php bin/magento module:enable Aurora_Simpleblog php bin/magento setup:upgrade ``` ### Instalacja manualna 1. Rozpakuj archiwum 2. Przenieś pliki modułu na serwer do lokalizacji: ```text {Magento root} └── app/ └── code ``` 3. W folderze głównym Magento wykonaj następujące polecenia: ```text php bin/magento module:enable Aurora_Simpleblog php bin/magento setup:upgrade ``` ### Dziękujemy za zainteresowanie naszymi modułami! ## Changelog ### v2.1.0 - Dodanie widgetu z lista postów ### v2.0.11 - Dodanie routingu wszystkim postom. ### v2.0.10 - Zmiana domyślengo sposoby sortowania postów. ### v2.0.9 - ??? ### v2.0.8 - Naprawa typów zmiennych. ### v2.0.7 - Zmiana kodu pod standarty PHP7.4. ### v2.0.6 - Dodanie zdjęć w widget'dzie Last Posts. ### v2.0.5 - Obsługa błędu podczas gdy ID w bloku AssignedPost nie istnieje lub jest nullem. ### v2.0.4 - Naprawa paginacji kategorii. ### v2.0.3 - Change requirements to magento/framework@103.0.*. ### v2.0.2 - Poprawa typów w konstruktorach. - Dodanie API ACL. ### v2.0.1 - Naparawa Tytułu w widoku renderującym post. ### v2.0.0 - Dodanie API dla Modeli. - Zmiana kodu pod PSR'y. ### v1.5.2 - Sprawdzenie czy data do unserializacji nie jest null'em(Block/Post/Post) ### v1.5.1 - Dodanie FileUploader'a ### v1.5.0 - Dodanie bloku AllPosts - Dodanie bloku CategoryTitle ### v1.4.10 - ??? ### v1.4.9 - Naprawa paginacji - Naprawa Limmiter'a - Dodanie config.xml z domyślną konfiguracją ### v1.4.8 - Format plików .xml pod PSR ### v1.4.7 - Aktualizacja README.md ### v1.4.6 - Naprawa unittestów - Naprawa niecachujących się elementów ### v1.4.5 - Update Post Collection, to retrive table name via magento. - Aktualizacja kollekcji Postów ### v1.4.4 - Naprawa DataProvider'ów - Pozbycię się używania zmiennych Globalnych - Naprawa wysyłania zdjęć. ### v1.4.3 - Naprawa literówki, występującej w fukcji budującej URL. ### v1.4.2 - Dodanie szablonu z przypisanymi postami na stronie produktu. ### v1.4.1 - Dodanie możliwości przypisania postu do produktów. - Dodanie możliwości wstawienia 'Zdjęcia Głównego' dla postu. - Reorganizacja wyglądu formularza edytującego post. ### v1.3.5 - Naprawa widoku wyświetlającego wszystkie kategorie. ### v1.3.4 - Dodanie klasy pomocniczej do kofiguracji. ### v1.3.3 - Naprawa kontrollera/akcji Post/Save po stronie PA ### v1.3.2 - ??? ### v1.3.1 - Aktualizacja zależności do magento@2.3.* ### v1.3.0 - Wyrenderowanie metadanych po stronie widoku aplikacji. ### v1.2.0 - Dodanie możliwości powiązanai produktów z postami.