Simple Blog - Dokumentacja modułu Magento 2

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.

Image 4

Formularz składa się z dwóch sekcji: Category Details, Category SEO.

Image 1

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

Image 6

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.

Image 9

Aby dodać post do nowo utworzonej kategorii kieruj się do Content > Blog Posts. Przejdź do formularza poprzez przycisk Add New Post.

Image 5

Na stronie add new post znajdziesz trzy sekcje: Post Details, Post SEO, Related Products.

Image 10

Image 8

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

Image 16

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.

Image 12

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.

Image 17

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.

Image 2

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.

Image 7

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ą.

Image 19

Demo

Instalacja modułu

Instalacja przez Composer

  1. Dodaj repozytorium do pliku composer.json:
"repositories": [
    ...
    {
        "type": "vcs",
        "url": "git@git.auroracreation.com:aurora-modules/simple-blog.git"
    }
    ...
],
  1. Zmodyfikuj plik composer.json:
"require": {
    ...
    "aurora/simpleblog": "*"
    ...
},
  1. W folderze głównym Magento wykonaj następujące polecenia:
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:
{Magento root}
└── app/
    └── code
  1. W folderze głównym Magento wykonaj następujące polecenia:
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.