Magazine WP

Abilitare le API

Le API di Wordpress sono attive di default.
Le chiamate pubbliche non richiedono nessuna autenticazione, le chiamate che modificano dati vogliono la basic athentication.

Dal menu Impostazioni -> Permalink abilitare gli URL BELLI per avere le API sotto l'endpoint /wp-json/wp/v2/

Scaricare il plugin Basic Authentication da qui: https://github.com/WP-API/Basic-Auth

Dipendenze e configurazione dell'host

Inserire il dominio del dns pubblico nel file host
sudo nano /etc/hosts
Metterci il loopback in TEST

127.0.0.1  designbestmagazine.dbdemo47.com
127.0.0.1  designbestmagazine.com www.designbestmagazine.com

E installare i pacchetti intl e imagick

sudo apt install php8.0-intl php8.0-imagick

Ambiente di Test

https://designbestmagazine.dbdemo47.com/

Admin    -> admin
Password -> W3bm0b1l!

IMPORTANTE
Nell'ambiente di test, nel file wp-config.php inserire la costante

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', true );
define( 'WP_ENVIRONMENT_TYPE', 'staging' );  // mettere 'local' per sviluppo locale

In produzione rimuovere WP_ENVIRONMENT_TYPE e rimuovere WP_DEBUG e figli.

Creazione del tema child

Creare il tema figlio.
Scaricare il plugin Child Theme Configurator
Strumenti => Child themes e crearlo spuntando Separate Stylesheet e flaggare la casella per la copia dei menu.
Dal gestore dei temi selezionare e attivare il tema figlio appena creato.

Tema Sway - Theme Forest

Il nostro tema a pagamento è Sway preso da ThemeForest che collaborano con questi che si chiamano Envato.
Dalla pubblicità asserivano che il tema fosse basato su Bootstrap 5, in realtà è un vecchio Bootstrap 3.
Le credenziali di accesso sono:

mail: s.bracco@webmobili.it
user: cidrolino
psw:  C1drolino_2022

Con lo stesso login si può entrare su Envato API per creare un token in modo da fornire al plugin la possibilità di aggiornare i temi ThemeForest.
Il token attuale è

yaMStxmOvyqmpqCrtePopEmNNSUbo4R6

Una volta creato il token utilizzare la voce Envato Market nell'admin di Wordpress per avere l'aggiornamento dei temi ThemeForest.
Per aggiungere un tema bisogna procurarsi l'ID del tema ti ThemeForest.
Nel caso di Sway il suo ID si recupera dall'url

https://themeforest.net/item/sway-multipurpose-wordpress-theme-with-page-builder/30082633

è 30082633

Ecco la Guida Ufficiale

Tema bootScore

Ci sarebbe piaciuto molto, ma la redazione non ha apprezzato.

https://bootscore.me/documentation/
Tema basato totalmente su bootstrap 5 e jQuery che permette di modificare i CSS utilizzando sintassi SCSS.

https://bootscore.me/#download

• Scaricare bootScore e bootScore Child. Aggiungerli entrambi e attivare il tema figlio.
• Aggiunti i font nella cartella /fonts seguendo la guida https://bootscore.me/documentation/google-fonts/
• Creato /css/scss/_bscore_custom_fonts.scss con le chiamate prese dalla guida sopra
• Aggiornato /css/scss/bootstrap.min.scss aggiungendo la chiamata

@import "bscore_custom_fonts";

• Copiato il file header.php dal tema padre per modificare il nome dell'immagine logo in logo.png

<!-- Navbar Brand -->
<a class="navbar-brand xs d-md-none" href="<?php echo esc_url(home_url()); ?>"><img src="<?php echo esc_url(get_stylesheet_directory_uri()); ?>/img/logo/logo-sm.png" alt="logo" class="logo xs"></a>
<a class="navbar-brand md d-none d-md-block" href="<?php echo esc_url(home_url()); ?>"><img src="<?php echo esc_url(get_stylesheet_directory_uri()); ?>/img/logo/logo.png" alt="logo" class="logo md"></a>

• Copiato il logo in img/logo/logo.png e img/logo/logo-sm.png

Altri plugin base

• Installare Polylang PRO versione a pagamento per le funzionalità multi-lingua.
  

Andare su Lingua => impostazioni => Media => Impostazioni e spuntare Duplica automaticamente i media in tutte le lingue per fare in modo che i media vengano uploadati già con un record di lingua.

• Installare Yoast SEO per la gestione del SEO

Creare le categories prima.

Brevo nel footer

Scaricare il plugin Newsletter, SMTP, Email marketing and Subscribe forms by Brevo.
Il plugin permetterebbe autonomamente di creare dei form da inserire con uno shortcode ma NON FUNZIONA, NON CREARE FORM DA QUI

Il workaround è quello di utilizzare il solito Contact Form 7
prima bisogna andare nel suo menu alla voce Integrazione e attivare l'integrazione con Brevo inserendo l' API Key dell'account.

Estensioni Designbest del tema

I file che estendono il tema sono stati messi nella cartella del tema figlio sotto il folder Designbest Vengono chiamati in causa tramite il file functions.php

// DESIGNBEST EXTENSIONS
require_once('Designbest/DesignbestAutoload.php');
// END DESIGNBEST EXTENSIONSS

Lead Manager

Per poter aggiungere il form di Lead Manager è stata fatta un'estensione del tema che aggiunge un shortcode al sistema Wordpress.

Per utilizzarlo basta scrivere

[leadmanagerform]

all'interno di un post con l'editor di testo.
I suoi argomenti, da specificare come attributo="valore", sono i seguenti:

• shop_id - Se specificato sarà un lead privato
• product_id - ID di un prodotto, ambient e manufacturer verranno ignorati
• manufacturer_id - ID di un manu
• ambient_id - ID ambiente
• image_url - URL completa di immagine
• page_title - Titolo della pagina (opzionale, per ora non viene utilizzato).
• show_ambients_dropdown - Se impostato a "true" mostra la tendina di scelta dell'ambiente, comanda su ambient_id
• show_budget_box - Se impostato a "true" mostra un box testuale che verrà concatenato al messaggio della request

API Wordpress

Attivare i campi meta.
Di base i custom fields sono bloccati dalle API Wordpress.
Per abilitarli è necessario aggiungere al file
/wp-content/themes/<nome-del-tema-child>/functions.php
del tema corrente la chiamata a register_meta() specificando nome e tipologia dei campi in questione.

// REST API - Registered Meta Fields
// https://developer.wordpress.org/rest-api/extending-the-rest-api/modifying-responses/#working-with-registered-meta-in-the-rest-api
register_meta( 'post', 'meta_title', array( 'type'=>'string', 'description' => 'SEO meta title per il post.', 'single' => true,  'show_in_rest' => true) );
register_meta( 'post', 'meta_description', array( 'type'=>'string', 'description' => 'SEO meta description per il post.', 'single' => true,  'show_in_rest' => true) );
register_meta( 'post', 'manufacturer_id', array( 'type'=>'integer', 'description' => 'Se presente in articolo, contiene ID del manufacturer.', 'single' => true,  'show_in_rest' => true) );
// END REST API - Registered Meta Fields

Forse prima di effettuare un inserimento di post è necessario abilitare i campi personalizzati dall'interfaccia admin di editing di un post (tre puntini, preferenze, pannelli, campi personalizzati) ma non ne siamo certi.

Nella nostra estensione abbiamo specificato i register_meta() all'interno del costruttore di DesignbestMagazineExtensions (tutto centralizzato)

Categorie e sottocategorie

Chiamata Json POST http://designbestmagazine.dbdemo47.com/wp-json/wp/v2/categories

{
    "name": "Bagni", 
    "slug": "bagni",
    "parent": 2,
    "description": "Descrizione bagni"
}

Articoli

Chiamata Json POST http://designbestmagazine.dbdemo47.com/wp-json/wp/v2/posts

{
    "title": "Titolo articolo",
    "content": "Descrizione articolo.",
    "categories": 1,
    "status": "publish",
    "slug": "titolo-articolo",
    "featured_media": IDmedia,
    "comment_status": "closed",
    "meta": {
      "meta_title": "SEO meta title del post",
      "meta_description": "SEO meta description del post",
      "manufacturer_id": 313
    }
}

Immagini e media

Chiamata Json POST http://designbestmagazine.dbdemo47.com/wp-json/wp/v2/media?lang=it
Inserire obbligatoriamente il parametro lang per attivare la duplicazione media per lingua di Polylang PRO.

• Sezione Authorization
  

Settare Basic Auth -> nome utente e password admin di wordpress

• Sezione Header
  

Importanti gli header

Content-Type         image/jpeg
Content-Disposition  form-data; filename="rotto.jpg"

• Sezione Body
  

Indicare il file fisico in modo che venga fatta la copia byte per byte

Home Page Url - Problema settando pagina statica

Con PolyLang si crea un problema di url quando invece della classica Ultimi Articoli, come homepage si seleziona una pagina statica.
La url dell'homepage continua a mostrare il permalink dell'articolo.

Per rimediare bisogna andare nelle impostazioni delle lingue (Impostazioni->Lettura->modifica Urls) e
selezionare l'opzione Il frontend mostra il codice della lingua invece del nome o id pagina

https://polylang.pro/doc/define-your-home-page-as-a-static-page/

Plugin a pagamento - Aggiornamenti

Aggiornare i plugin non è mai semplice, in particolare abbiamo quelli a pagamento che devono essere aggiornati in modo custom.

PolyLang PRO

99€ all'anno
Se non si aggiorna in automatico, bisogna entrare nel portale
https://polylang.pro/
e loggarsi con le credenziali

s.vincenzi@webmobili.it
xIfm^EWLS6IVuYf8Y2^@neJqhZ5Xm@vD

Per poi navigare nella sezione Download
tirare giù lo zip
ed uploadarlo nella sezione Plugin come se fosse una nuova aggiunta (WP si accorge che è una sostituzione di nuovo su vecchio).

Tema Sway - Theme Forest

59€ ogni 6 mesi
Per aggiornare il tema leggere l'apposita sezione #Tema Sway - Theme Forest

WPBakery Page Builder

56$ all'anno
https://support.wpbakery.com/
Account

username: s.vincenzi@webmobili.it
password: W3bm0b1l!
licenza : eb88acb8-c966-4725-80d6-75249a09a5a4
scadenza: 28-10-2023

Slider Revolution

42,70€ ogni anno
https://account.sliderrevolution.com/
Account

username: s.vincenzi@webmobili.it
password: W3bm0b1l!
licenza : 8f137c-ad20cc-d86203-6564ef-925130

Rinnovo Certificati

Su register stiamo pagando i certificati dei domini designbestmagazine.com e designbestmagazine.it.

Quando c'è da fare il rinnovo è necessario cliccare su
Richiedi nuovo CSR
.

In ordine dovremo

• Creare un nuovo .csr da Merida
• L'operazione precedente restituisce un .csr e una chiave privata .key
• Aprire il pannello di Register e inserire il contenuto del .csr per fare generare il certificato

Per generare il .csr utilizzare

openssl req -new -newkey rsa:2048 -nodes -keyout designbestmagazine.com_private_key.key -out designbestmagazine.com.csr
openssl req -new -newkey rsa:2048 -nodes -keyout designbestmagazine.it_private_key.key -out designbestmagazine.it.csr

cat designbestmagazine.it_ssl_certificate.crt designbestmagazine.it_ssl_certificate_intermediate.crt >> designbestmagazine.it_ssl_certificate_bundle.crt
cat designbestmagazine.com_ssl_certificate.crt designbestmagazine.com_ssl_certificate_intermediate.crt >> designbestmagazine.com_ssl_certificate_bundle.crt