Portfolio – prezentacja projektów na stronie

Dokumentacja CC WordPress Portfolio

Spis treści

1. Wprowadzenie
2. Instalacja
3. Aktywacja licencji
4. Panel zarządzania
5. Dodawanie projektów portfolio
6. Konfiguracja atrybutów
7. Zarządzanie galerią zdjęć
8. Kategorie i tagi
9. Szablony i wyświetlanie
10. Permalinki i URL
11. Integracje z mediami społecznościowymi
12. Import i eksport
13. Ustawienia zaawansowane
14. Funkcje dla deweloperów
15. Rozwiązywanie problemów
16. FAQ

1. Wprowadzenie

• Niestandardowy typ wpisu (Custom Post Type) dla projektów portfolio
• Zaawansowany system atrybutów dla każdego projektu
• Galerie zdjęć z funkcją lightbox
• Kategorie i tagi dla projektów
• Skrócone nazwy projektów
• Przyciski udostępniania w mediach społecznościowych
• Import i eksport projektów i ustawień
• Możliwość dostosowania szablonów wyświetlania
• Niestandardowe permalinki dla projektów

2. Instalacja

• WordPress 5.0 lub nowszy
• PHP 7.2 lub nowszy
• Uprawnienia do instalacji wtyczek

1. Pobierz plik ZIP wtyczki z oficjalnego sklepu cocos.codes
2. Zaloguj się do panelu administracyjnego WordPress
3. Przejdź do: Wtyczki > Dodaj nową > Wyślij wtyczkę
4. Kliknij „Wybierz plik” i wybierz pobrany plik ZIP
5. Kliknij „Zainstaluj teraz”
6. Po zakończeniu instalacji kliknij „Włącz wtyczkę”

3. Aktywacja licencji

1. Po instalacji przejdź do menu Portfolio > Ustawienia
2. Wybierz zakładkę „Licencja”
3. Wprowadź klucz licencyjny otrzymany po zakupie
4. Kliknij „Aktywuj licencję”
5. Po pomyślnej aktywacji zobaczysz komunikat potwierdzający i odblokowane zostaną wszystkie funkcje wtyczki

4. Panel zarządzania

• Portfolio – lista wszystkich projektów
• Dodaj nowy – dodawanie nowego projektu portfolio
• Kategorie – zarządzanie kategoriami projektów
• Tagi – zarządzanie tagami projektów
• Atrybuty – zarządzanie niestandardowymi atrybutami projektów
• Ustawienia – konfiguracja wtyczki z kilkoma zakładkami:
  • Szablony – ustawienia wyświetlania szablonów
  • Wyświetlanie – opcje wizualne
  • Galeria – ustawienia galerii zdjęć
  • Atrybuty – konfiguracja wyświetlania atrybutów
  • URL i Permalinki – struktura adresów URL
  • Integracja – połączenia z mediami społecznościowymi
  • Import/Eksport – narzędzia do transferu danych
  • Zaawansowane – dodatkowe opcje
  • Licencja – zarządzanie licencją wtyczki

5. Dodawanie projektów portfolio

1. Przejdź do Portfolio > Dodaj nowy
2. Wprowadź tytuł projektu
3. Dodaj opis projektu w edytorze WordPress
4. Ustaw obraz wyróżniający (miniaturę projektu)
5. Skonfiguruj sekcje dodatkowe:
   • Skrócona nazwa projektu – opcjonalny krótszy tytuł używany w listingach
   • Atrybuty portfolio – dodatkowe informacje o projekcie (rok, lokalizacja, itp.)
   • Galeria zdjęć – dodatkowe zdjęcia prezentujące projekt
6. Przypisz projekt do kategorii i dodaj tagi
7. Kliknij „Opublikuj” lub „Zaktualizuj”

6. Konfiguracja atrybutów

1. Przejdź do Portfolio > Atrybuty
2. Na liście zobaczysz już zdefiniowane atrybuty (domyślnie są już dodane podstawowe)
3. Aby dodać nowy atrybut, kliknij przycisk „Dodaj nowy atrybut”
4. Wypełnij formularz:
   • Nazwa – nazwa atrybutu wyświetlana użytkownikom
   • Typ – rodzaj pola:
     • Tekst – krótka wartość tekstowa
     • Obszar tekstowy – dłuższy tekst wieloliniowy
     • Liczba – wartość numeryczna
     • Lista wyboru – pole select z predefiniowanymi opcjami
   • Opcje – lista wartości dla pola select (oddzielone przecinkami)
   • Pokaż na froncie – określa czy atrybut będzie widoczny dla odwiedzających
5. Kliknij „Zapisz atrybuty”, aby zachować zmiany

• Podczas tworzenia lub edycji projektu wypełnij wartości w sekcji „Atrybuty portfolio”
• Atrybuty zostaną automatycznie wyświetlone na stronie projektu zgodnie z ustawieniami
• Format wyświetlania atrybutów można skonfigurować w Ustawienia > Atrybuty

7. Zarządzanie galerią zdjęć

1. Podczas edycji projektu przejdź do sekcji „Galeria zdjęć”
2. Kliknij przycisk „Dodaj zdjęcia”
3. Wybierz pliki z biblioteki mediów lub wgraj nowe
4. Możesz zmienić kolejność zdjęć przeciągając je
5. Aby usunąć zdjęcie, kliknij link „Usuń” pod zdjęciem
6. Kliknij „Zaktualizuj” lub „Opublikuj”, aby zapisać zmiany

1. Przejdź do Portfolio > Ustawienia > Galeria
2. Ustaw liczbę kolumn w galerii
3. Włącz lub wyłącz funkcję lightbox
4. Zapisz ustawienia

8. Kategorie i tagi

1. Przejdź do Portfolio > Kategorie
2. Dodaj nowe kategorie lub edytuj istniejące
3. Możesz tworzyć hierarchię kategorii (kategorie nadrzędne i podkategorie)
4. Dla każdej kategorii możesz ustawić nazwę, slug (część URL) i opis

1. Przejdź do Portfolio > Tagi
2. Dodaj nowe tagi lub edytuj istniejące
3. Tagi pomagają w dodatkowym oznaczaniu projektów według cech, które nie pasują do struktury kategorii

• Podczas edycji projektu przypisz go do odpowiednich kategorii w sekcji po prawej stronie
• Dodaj tagi w sekcji tagów
• Kategorie i tagi są używane do:
  • Filtrowania projektów na stronie archiwum
  • Tworzenia stron kategorii z listą powiązanych projektów
  • Budowania struktury permalinków (opcjonalnie)
  • Wyświetlania powiązanych projektów

9. Szablony i wyświetlanie

1. Przejdź do Portfolio > Ustawienia > Szablony
2. Włącz lub wyłącz używanie szablonów z wtyczki
3. Wybierz, które szablony mają być nadpisywane przez wtyczkę:
   • Szablon pojedynczego projektu
   • Szablon archiwum projektów
   • Szablon kategorii projektów
4. Wybierz szablon z dostępnych opcji

1. Przejdź do Portfolio > Ustawienia > Wyświetlanie
2. Skonfiguruj następujące opcje:
   • Liczba projektów na stronie
   • Liczba kolumn w siatce projektów (dla różnych urządzeń)
   • Wyświetlanie podobnych projektów
   • Filtry kategorii na stronie archiwum
   • Nawigacja między projektami
   • Wyświetlanie tagów i kategorii
   • Wyświetlanie treści projektu

10. Permalinki i URL

1. Przejdź do Portfolio > Ustawienia > URL i Permalinki
2. Ustaw podstawowe slugi:
   • Portfolio base – podstawowy slug dla projektów (np. portfolio, projekty, realizacje)
   • Kategorie portfolio – slug dla kategorii (np. kategoria-portfolio, typ-projektu)
   • Tagi portfolio – slug dla tagów (np. tag-portfolio, etykieta)
3. Wybierz strukturę permalinków dla projektów:
   • Domyślna – portfolio/projekt-slug
   • Z kategorią – portfolio/kategoria/projekt-slug

11. Integracje z mediami społecznościowymi

1. Przejdź do Portfolio > Ustawienia > Integracja
2. Zaznacz opcję „Włącz przyciski udostępniania w mediach społecznościowych”
3. Zapisz ustawienia

• Facebook
• Twitter/X
• LinkedIn
• Pinterest (tylko gdy projekt ma obrazek)
• Email

12. Import i eksport

1. Przejdź do Portfolio > Ustawienia > Import/Eksport
2. W sekcji „Eksport ustawień” kliknij przycisk „Eksportuj ustawienia”
3. Plik JSON z ustawieniami zostanie pobrany na Twój komputer

1. Przejdź do Portfolio > Ustawienia > Import/Eksport
2. W sekcji „Import ustawień” kliknij przycisk „Wybierz plik” i wybierz wcześniej wyeksportowany plik JSON
3. Kliknij „Importuj ustawienia”
4. Po zakończeniu importu strona zostanie odświeżona z nowymi ustawieniami

1. Przejdź do Portfolio > Ustawienia > Import/Eksport
2. W sekcji „Eksport projektów” kliknij przycisk „Eksportuj projekty”
3. Plik CSV z projektami zostanie pobrany na Twój komputer

1. Przejdź do Portfolio > Ustawienia > Import/Eksport
2. W sekcji „Import projektów” kliknij przycisk „Wybierz plik” i wybierz wcześniej wyeksportowany plik CSV
3. Kliknij „Importuj projekty”
4. Po zakończeniu importu zobaczysz komunikat z podsumowaniem importu

13. Ustawienia zaawansowane

1. Przejdź do Portfolio > Ustawienia > Zaawansowane
2. Włącz lub wyłącz poszczególne moduły:
   • Moduł atrybutów – pozwala na definiowanie i wyświetlanie niestandardowych atrybutów
   • Moduł galerii – umożliwia dodawanie galerii zdjęć do projektów
   • Moduł kategorii – włącza obsługę kategorii i tagów dla projektów

1. W sekcji „Niestandardowe CSS” możesz dodać własne style CSS
2. Style będą dodane do wszystkich stron portfolio
3. To pozwala na dostosowanie wyglądu portfolio bez modyfikacji plików motywu

1. Jeśli chcesz przywrócić wszystkie ustawienia do wartości domyślnych, kliknij przycisk „Resetuj ustawienia”
2. Potwierdź, że chcesz zresetować ustawienia
3. Wszystkie zmiany zostaną utracone i przywrócone zostaną domyślne wartości

14. Funkcje dla deweloperów

// Wyświetl atrybuty portfolio
display_portfolio_attributes($post_id = null, $echo = true);

// Pobierz wartość konkretnego atrybutu portfolio
get_portfolio_attribute($attribute_name, $post_id = null);

// Pobierz wszystkie atrybuty portfolio z wartościami
get_all_portfolio_attributes($post_id = null);

// Wyświetl galerię zdjęć portfolio
display_portfolio_gallery($post_id = null, $args = [], $echo = true);

// Pobierz ID zdjęć z galerii portfolio
get_portfolio_gallery_ids($post_id = null);

// Sprawdź czy wpis portfolio ma galerię zdjęć
has_portfolio_gallery($post_id = null);

// Wyświetl kategorie portfolio dla danego wpisu
display_portfolio_categories($post_id = null, $args = [], $echo = true);

// Wyświetl tagi portfolio dla danego wpisu
display_portfolio_tags($post_id = null, $args = [], $echo = true);

// Wyświetl listę kategorii portfolio
display_portfolio_categories_list($args = [], $echo = true);

<?php
// Wyświetl atrybuty projektu
// Użycie funkcji pomocniczej do wyświetlenia atrybutów
if (function_exists('\CCWordPressPortfolio\display_portfolio_attributes')) {
   \CCWordPressPortfolio\display_portfolio_attributes();
}
?>

<?php
// Wyświetlanie tagów
// Wyświetl tagi projektu
if (function_exists('\CCWordPressPortfolio\display_portfolio_tags')) {
   echo '<div class="portfolio-tags-wrapper">';
   echo '<span class="portfolio-tags-label">' . __('Tagi: ', 'cc-wordpress-portfolio') . '</span>';
   \CCWordPressPortfolio\display_portfolio_tags();
   echo '</div>';
}
?>

15. Rozwiązywanie problemów

1. Sprawdź, czy projekty są opublikowane (status „Opublikowany”)
2. Upewnij się, że licencja wtyczki jest aktywna
3. Sprawdź, czy używane są szablony z wtyczki (Ustawienia > Szablony)
4. Sprawdź, czy struktura permalinków jest poprawnie skonfigurowana
5. Odśwież strukturę permalinków w ustawieniach WordPress (Ustawienia > Permalinki)
6. Wyczyść pamięć podręczną przeglądarki i serwera, jeśli korzystasz z systemu buforowania

1. Sprawdź, czy moduł atrybutów jest włączony (Ustawienia > Zaawansowane)
2. Upewnij się, że atrybuty mają zaznaczoną opcję „Pokaż na froncie” (Portfolio > Atrybuty)
3. Sprawdź, czy dla projektu zostały wprowadzone wartości atrybutów
4. Sprawdź, czy używany szablon obsługuje wyświetlanie atrybutów

1. Sprawdź, czy moduł galerii jest włączony (Ustawienia > Zaawansowane)
2. Upewnij się, że dodałeś zdjęcia do galerii projektu
3. Sprawdź, czy funkcja lightbox jest włączona (Ustawienia > Galeria)
4. Wyczyść pamięć podręczną przeglądarki i serwera
5. Sprawdź, czy nie ma konfliktów z innymi wtyczkami wykorzystującymi lightbox

16. FAQ