# Wp-cli
[toc]

## Czym jest Wp-cli?
Wp-cli to proste, w pełni darmowe narzędzie, które pozwala zarządzać stronami w Wordpressie za pomocą lini komend (SSH), a w przypadku Hyperone - z poziomu platformy, bez instalacji dodatkowych narzędzi.

Wp-cli szczególnie doceniane jest przez administratorów którzy zarządzają jednocześnie wieloma stronami lub zwyczajnie lubią automatyzować procesy, oszczędzając czas. Jakie możliwości oferuje wp-cli?

Z poziomu wiersza poleceń SSH użytkownik jest w stanie kompleksowo zarządzać stroną opartą na CMS Wordpress - od jej utworzenia, modyfikacji i aktualizacji, kończąc na optymalizacji bazy danych. Szereg poleceń oraz łatwość zarządzania sprawia, że wp-cli zyskuje coraz większą liczbę zwolenników. A to jeszcze nie wszystko, bo z pomocą tego narzędzia można również zarządzać użytkownikami, harmonogramem WP-Cron lub wtyczkami na stronie.

### Oszczędność czasu
Zamiast ręcznego wyszukiwania każdej opcji (dla każdej ze stron lub np. każdej z wtyczek, dodajmy), z pomocą kilku poleceń można w prosty sposób kompleksowo zarządzać Wordpressem.

Chociaż Wp-cli wymaga znajomości konsoli i poleceń, nie jest narzędziem zarezerwowanym wyłącznie dla programistów i zaawansowanych administatorów. Co więcej - osoby rozpoczynające pracę z trybem konsolowym, szczególnie docenią brak wymagania instalacji dodatkowego oprogramowania oraz zarządzania oddzielnymi hasłami.

W HyperOne narzędzie dostępne jest wprost z aplikacji wspierającej "console", która umożliwia dostęp do trybu tekstowego, z którego bezpośrednio można uruchomić wp-cli. Warto dodać, że Wp-cli na platformie HyperOne dostępne jest w obrazach PHP.

## Jakie możliwości oferuje narzędzie wp-cli?

Poniżej znajduje się lista przykładowych poleceń, które dostępne są w trybie konsolowym. Zacznijmy od samego narzędzia wp-cli:

| wp cli <command> | Opis |
| -------- | -------- |
| wp cli check-update |Sprawdzenie, czy nowa wersja wp-cli jest dostępna |
|wp cli update |Aktualizacja wp-cli do najnowszej wersji |
| wp cli info | Wyświetlanie szczegółów dotyczących środowiska wp-cli |
| wp cli cache | Zarządzanie wewnętrznym cache'm wp-cli |

### Bazy danych
Za pomocą konsoli wudowanej w platformę, można również w łatwy sposób zarządzać posiadanymi w Wordpressie bazami danych.

| wp db <command> | Opis |
| -------------- | ---------------------------------------------------------------------- |
| wp db create | Tworzenie nowej bazy danych |
| wp db drop | Usuwanie istniejącej bazy danych |
| wp db check | Sprawdzenie obecnego statusu bazy danych |
| wp db clean | Polecenie usuwa wszystkie tabele z kodem `$table_prefix` z bazy danych |
| wp db export | Eksport bazy danych do pliku lub STDOUT. |
| wp db import | Import bazy danych z pliku lub z STDIN. |
| wp db optimize | Optymalizacja bazy danych |
| wp db repair | Naprawa bazy danych |
| wp db reset | Usunięcie wszystkich tabeli z bazy danych |
| wp db search | Wyszukiwanie dowolnego stringu w bazie danych |
### Motywy

Instalacja motywów może odbywać się pojedynczo, można także je dodawać, aktualizować i usuwać na wielu posiadanych stronach jednocześnie.

| wp theme <command> | Opis |
| -------- | -------- |
| wp theme activate | Aktywacja motywu |
| wp theme delete | Usunięcie jednego lub więcej motywów |
| wp theme disable | Wyłączanie motywu w instalacji wielostanowiskowej WordPress |
| wp theme enable | Włączanie motywu w instalacji wielostanowiskowej WordPress |
| wp theme get | Wyświetlanie szczegółów dotyczących motywu |
| wp theme install | Instalacja jednego lub więcej motywów |
| wp theme list | Wyświetlanie listy motywów |

### Posty

Narzędzie wp-cli pozwala także w prosty sposób zarządzać postami publikowanymi na stronie.

| wp post <command>| Opis |
| -------- | -------- |
| wp post create | Tworzenie nowego postu |
| wp post delete | Usuwanie istniejącego postu |
| wp post edit | Uruchomienie edytora systemowego w celu edycji postu |
| wp post exists | Sprawdzenie, czy post istnieje |
| wp post list | Wyświetlenie listy istniejących postów |

### Obrazy i załączniki
Kolejną przydatną opcją jest obsługa obrazów i mediów, oferująca regenerację miniaturek oraz poprawienie orientacji, dostępna poprzez konsolę.

| wp media <command> | Opis |
| -------- | -------- |
| wp media fix-orientation | Poprawienie orientacji obrazu dla jednego lub większej ilości załączników |
| wp media image-size | Wyświetlenie listy rozmiarów obrazów zarejestrowanych w WordPress |
| wp media import | Tworzenie załączników z plików lokalnych lub adresów URL |
| wp media regenerate | Regeneracja miniaturek dla jednego lub więcej załączników |

### Zarządzanie pakietami
Obsługa pakietów możliwa jest za pomocą poniższych poleceń dostępnych w oknie konsoli.

|wp package <command>| Opis |
| ------------------ | -------------------------------------------- |
| wp package browse | Przeglądanie dostępnych pakietów wp-cli |
| wp package install | Instalowanie pakietu wp-cli |
| wp package list | Wyświetlanie zainstalowanych pakietów wp-cli |
| wp package path | Wyświetlanie ścieżki do pakietu lub katalogu |
| wp package uninstall | Usuwanie pakietów wp-cli |
| wp package update | Aktualizacja wszystkich zainstalowanych pakietów do najnowszej wersji |

### Menu
Tworzenie menu na stronie internetowej oraz zarządzanie nimi także możliwe jest poprzez SSH.

| wp menu <command> | Opis |
| -------------- | --------------------- |
| wp menu delete | Usuwanie jednego lub więcej menu |
| wp menu item | Wyświetlanie listy, dodawanie i usuwanie pozycji powiązanych z menu |
| wp menu list | Wyświetlanie listy dostępnych menu |
| wp menu location | Przypisywanie, usuwanie i wymiana lokalizacji menu |
| wp menu create | Tworzenie nowego menu |

### Harmonogramy

Wp-Cron to narzędzie wykorzystywane do autmatycznego zarządzania stronami. Można ustawić w nim sprawdzanie aktualizacji, publikację postów i pingbacki, które będą uruchamiały się same, bez ingerencji administratora.

| wp cron <command> | Opis |
| -------- | -------- |
| wp cron event | Harmonogramuje, uruchamia i usuwa zdarzenia WP-Cron |
| wp cron schedule | Wyświetla harmonogramy WP-Cron |
| wp cron test | Testowanie WP-Cron spawning system i wyświetlenie informacji o jego stanie |

### Zarządzanie pamięcią podręczną

Ostatnią możliwością (wymienioną tutaj, bo lista poleceń w wp-cli jest o wiele dłuższa) jest administrowanie pamięcią podręczną.

| wp cache <command> | Opis |
| --------------- | -------------------------------------------------- |
| wp cache add | Dodawanie wartości do pamięci podręcznej obiektu |
| wp cache decr | Zmniejszenie wartości w pamięci podręcznej obiektu |
| wp cache delete | Usuwanie wartości w pamięci podręcznej obiektu |
| wp cache flush | Czyszczenie pamięci podręcznej obiektów |
| wp cache get | Pobranie wartości z pamięci podręcznej obiektu |

Wszystkie polecenia dostępne w konsoli można znaleźć na stronie https://developer.wordpress.org/cli/commands/

Jak już doskonale widać, obsługa konsoli nie wymaga specjalistycznej wiedzy, a polecenia są na tyle intuicyjne, że poradzą sobie z nią administratorzy posiadający nawet podstawową znajomość języka angielskiego.

### Podsumowanie

Korzystanie z narzędzia wp-cli jest darmowe i pozwala administratorom oszczędzić znaczną ilość czasu. Zachęcamy do wypróbowania możliwości, jakie w zarządzaniu Wordpressem daje tryb konsolowy.

Osobom, które mają obawy przed samodzielnym korzystaniem z wp-cli, przypominamy o nowej usłudze Kopii Bezpieczeństwa (którą można aktywować nawet na krótki, godzinowy okres czasu). Dzięki tej Usłudze, użytkownicy mogą bez obaw wprowadzać zmiany na Platformie, a w razie niepowodzenia - samodzielnie przywrócić poprzednią wersję, bez potrzeby kontaktu z obsługą techniczną Hyperone.

### Plan
lista przykładowych możliwości https://developer.wordpress.org/cli/commands/
podkreślenie zalet

## Ważne
Sprawdzenie bezpieczeństwa wersji

Oszczędność czasu
Wsparcie (samouczki)

WP-CLI jest u nas dostępne w obrazach PHP

dostęp do konsoli jest bardzo prosty

Nie wymaga to instalacji dodatkowego oprogramowania, ani zarządzania hasłami, bo można wykorzystać aplikacje wspierającą "console", która umożliwia dostęp do tekstowej konsoli, w której można uruchomić WP-CLI

Sprawna instalacja oprogramowania

**Coś jeszcze?**

## Konkurencja:

### Cyberfolks
https://cyberfolks.pl/blog/wp-cli-co-to-jest-i-jak-usprawnia-prace-z-wordpress/
* krótko o narzędziu
* instalacja wp-cli z linkami do poradników
* przykładowe polecenia
* dot. użytkowników,
* wtyczek, motywów,
* i kilka innych
* (Regenerowanie (naprawa) miniaturek obrazków WordPress,
* Import oraz eksport bazy danych,
* Masowa zmiana wartości w bazie danych),

* odnośnik do https://developer.wordpress.org/cli/commands/

### nazwa.pl
https://www.nazwa.pl/blog/wp-cli-na-hostingu-w-nazwapl
* krótko o narzędziu
* podstawowe funkcje
* łączenie z ssh (z linkami do poradników)
* wp find
* wp core update
* instalacja motywu, plubinu W3 Total Cache
* eksport iport z bazy
* dla bardziej zaawansowanych - pętla

### zenbox
https://pomoc.zenbox.pl/pl/kb/articles/wp-cli-wprowadzenie-i-obsluga
* wprowadzenie - co to jest wp-cli
* instalacja pluginu (z linkiem do poradnika)
* polecenia dot. użytkownika (tworzenie, zmiana, usuwanie)

### webinsider
https://webinsider.pl/wordpress-wp-cli/

* krótko o narzędziu
* linki do poradników (cron, wordpress multisite)
* instalacja krok po kroku
* przykładowe polecenia
* aktualizacja wp-cli
* aktualizacja wordpressa
* motywy
* wtyczki
* inne
* wp media regenerate
* wywołanie cron
* praca z bazą danych
* wp-cli z uprawnieniami innego użytkownika

### home.pl
brak treści ntt.
jest aby wzmianka na forum https://forum.home.pl/threads/ssh-szybka-aktualizacja-wordpressa-bez-logowania.1257/

### dhosting
https://dhosting.pl/community/wprowadzamy-wp-cli-dla-wordpressa-na-serwerach-ewh/
* krótko o narzędziu
* odnośnik do https://wp-cli.org/
* aktywacja ssh - link do poradnika
* link do logowania się do dhosting