WordPress: un plugin per caricare video YouTube in modo veloce, leggero e responsive

YouTube video player in WordPress
YouTube video player in WordPress

Elaborando i concetti espressi in questo articolo: “Come inserire un video YouTube in una pagina web in modalità responsive e leggera”  che ho scritto per il Blog della Cooperativa Elzevira, ho pensato che potesse essere utile proporre questa modalità di caricamento dei video di YouTube anche con un plugin per WordPress.

In pratica si tratta di caricare i video di YouTube senza pre-caricare il player, in modo di velocizzare in maniera drastica il caricamento della pagina. Viene caricata solo l’immagine di copertina del video e viene sovrapposto il simbolo “play” del video. Questa operazione si rivela particolarmente utile quando i video nella pagina sono parecchi.

Solo al momento del click sul simbolo “play” viene caricato il player e mostrati eventualmente i controlli e le altre informazioni.

Leggi tutto

WordPress: un plugin per un widget che mostra il link ad un post o una pagina con riassunto e immagine in evidenza.

widget-mspagelinkQuesto è un plugin davvero semplice, serve a mostrare nelle aree dei widget, un link con il titolo di una pagina (o di un post), l’immagine in evidenza (se caricata) e opzionalmente anche il riassunto del contenuto della pagina.

Lo schema per scrivere il widget l’ho preso da questo sito: http://www.wpbeginner.com/wp-tutorials/how-to-create-a-custom-wordpress-widget/ che spiega molto facilmente come costruirsi il proprio widget personalizzato. Il widget è stato poi inserito in un plugin.

Una caratteristica di questo widget è quella di poter mostrare un riassunto anche nel caso delle “pagine” di WordPress nelle quali a differenza dei post, non è possibile inserire l’ excerpt. La funzione che ho utilizzato è pubblicata qui: http://fullrefresh.com/2013/08/02/getting-a-wp-post-excerpt-outside-the-loop-updated/ . E’ molto utile perché non solo permette di stabilire la lunghezza del riassunto in parole, senza quindi troncare il testo, ma esegue anche un accurata rimozione degli shortcode mantenendo i ritorni a capo e la formattazione di base.

widget-mspagelink-adminpanelIn questa immagine si vede come viene mostrato il widget nel pannello amministrativo e i settaggi che è possibile impostare.

L’unico parametro che è veramente necessario inserire è l’ID del post o della pagina. Viene anche effettuato un controllo che questo corrisponda ad un articolo effettivamente esistente.

I parametri sono:

  1. Titolo (Titolo del Widget)
  2. Post ID (ID del post / pagina)
  3. Dimensione dell’immagine (a scelta: “thumbnail”,”medium”,”large”,”full”)
  4. Allineamento dell’immagine (a scelta: “aligncenter”,”alignleft”,”alignright”)
  5. Mostra il riassunto (si / no)
  6. Lunghezza riassunto (lunghezza in numero di parole)

Ed ecco il codice:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
<?php
/*
Plugin Name: MS Page Link
Plugin URI: http://www.spadamar.com/?p=713
Description: A plugin to add a simple widget to show a link to a page or post with the title, the featured image and optionally the excerpt.
Author: Mario Spada <spadamar@spadamar.com>
Version: 1.0
Author URI: http://www.spadamar.com
License: GPLv2
Text Domain:ms-pagelink
Domain Path:/lang/
*/
 
class MS_Page_link extends WP_Widget {
 
	public function __construct() {
		$widget_ops = array('classname' => 'MS_Page_link', 'description' => __('Displays a link to a page or a post with featured image!','ms-pagelink') );
		$this->WP_Widget('MS_Page_link', __('MS Page Link','ms-pagelink'), $widget_ops);
	}
 
	function widget($args, $instance) {
		extract($args, EXTR_SKIP);
		$title = empty($instance['title']) ? ' ' : apply_filters('widget_title', $instance['title']);
		$page_ID = empty($instance['page_ID']) ? '' : $instance['page_ID'];
		$img_size = empty($instance['img_size']) ? 'thumbnail' : $instance['img_size'];
		$img_alignment = empty($instance['img_alignment']) ? 'aligncenter' : $instance['img_alignment'];
		$show_excerpt = $instance['show_excerpt'] ? true : false;
		$excerpt_lenght = empty($instance['excerpt_lenght']) ? 35 : $instance['excerpt_lenght'];
		echo (isset($before_widget)?$before_widget:'');
		if (!empty($title))
		  echo $before_title . $title . $after_title;
		if (!empty($page_ID) && $this->does_post_exists($page_ID)) {
			echo "<div class='MSPagelink'>";
		  $featured_img = get_the_post_thumbnail( $page_ID, $img_size, array('class' => $img_alignment)); // (thumbnail, medium, large o full) ( alignleft , alignright , or aligncenter )
		  if (!empty($featured_img)) {
			echo "<div class='MSPagelink-img'>".$featured_img."</div>";
		  }
		  $style = "text-align:center";
		  echo '<p class="MSPagelink-txt" style="'.$style.'"><a href="'.get_permalink( $page_ID ).'">'.get_the_title( $page_ID ).'</a></p>';
		  if ($show_excerpt) {
			$excerpt_lenght = (is_numeric($excerpt_lenght) && $excerpt_lenght > 0) ? $excerpt_lenght : 35;
			$this_excerpt = $this->fr_excerpt_by_id($page_ID,$excerpt_lenght);
			echo "<div class='MSPagelink-excerpt'>".$this_excerpt."</div>";
		  }
		  echo "</div>";
		} else {
			echo sprintf( __( '<p>Page %s doesn\'t exist.</p>', 'ms-pagelink' ), $page_ID );
		}
		echo (isset($after_widget)?$after_widget:'');
	}
 
  public function form( $instance ) {
     $instance = wp_parse_args( (array) $instance, array( 'title' => '' ) );
     $title = $instance['title'];
     $page_ID = $instance['page_ID'];
     $img_size = $instance['img_size'];   
	 $img_alignment = $instance['img_alignment'];
	 $excerpt_lenght = $instance['excerpt_lenght'];
     ?>
     <p>
      <label for="<?php echo $this->get_field_id('title'); ?>"><?php echo __('Title:','ms-pagelink');?> 
        <input class="widefat" id="<?php echo $this->get_field_id('title'); ?>" 
               name="<?php echo $this->get_field_name('title'); ?>" type="text" 
               value="<?php echo esc_attr($title); ?>" />
      </label>
     </p>
     <p>
      <label for="<?php echo $this->get_field_id('page_ID'); ?>"><?php echo __('Post ID:','ms-pagelink');?> 
        <input class="widefat" id="<?php echo $this->get_field_id('page_ID'); ?>" 
               name="<?php echo $this->get_field_name('page_ID'); ?>" type="text" 
               value="<?php echo esc_attr($page_ID); ?>" />
      </label>
     </p>
     <p>
	 <?php
		$options = array("thumbnail","medium","large","full");
	 ?>
      <label for="<?php echo $this->get_field_id('img_size'); ?>"><?php echo __('Image size:','ms-pagelink');?> 
        <select class="widefat" id="<?php echo $this->get_field_id('img_size'); ?>" 
               name="<?php echo $this->get_field_name('img_size'); ?>">
		<?php
		foreach($options as $opt) {
			$selected = $opt == esc_attr($img_size) ? "selected='selected'" : "";
			echo "<option $selected>$opt</option>\n";			
		}
		?>
 
        </select>
      </label>
     </p>
     <p>
	 <?php
		$options = array("aligncenter","alignleft","alignright");
	 ?>
      <label for="<?php echo $this->get_field_id('img_alignment'); ?>"><?php echo __('Image alignment:','ms-pagelink');?> 
        <select class="widefat" id="<?php echo $this->get_field_id('img_alignment'); ?>" 
               name="<?php echo $this->get_field_name('img_alignment'); ?>">
		<?php
		foreach($options as $opt) {
			$selected = $opt == esc_attr($img_alignment) ? "selected='selected'" : "";
			echo "<option $selected>$opt</option>\n";			
		}
		?>          
        </select>
      </label>
      </p>
 
	  <p>
		<input class="checkbox" type="checkbox" <?php checked($instance['show_excerpt'], 'on'); ?> id="<?php echo $this->get_field_id('show_excerpt'); ?>" name="<?php echo $this->get_field_name('show_excerpt'); ?>" /> 
		<label for="<?php echo $this->get_field_id('show_excerpt'); ?>"><?php echo __('Show excerpt','ms-pagelink');?></label>
	  </p>
 
     <p>
      <label for="<?php echo $this->get_field_id('excerpt_lenght'); ?>"><?php echo __('Excerpt lenght:','ms-pagelink');?> 
        <input class="widefat" id="<?php echo $this->get_field_id('excerpt_lenght'); ?>" 
               name="<?php echo $this->get_field_name('excerpt_lenght'); ?>" type="text" 
               value="<?php echo esc_attr($excerpt_lenght); ?>" />
      </label>
     </p>
 
     <?php
 
  }
 
  function update($new_instance, $old_instance) {
    $instance = $old_instance;
    $instance['title'] = $new_instance['title'];
    $instance['page_ID'] = $new_instance['page_ID'];
    $instance['img_size'] = $new_instance['img_size'];
    $instance['img_alignment'] = $new_instance['img_alignment'];
    $instance['show_excerpt'] = $new_instance['show_excerpt'];
    $instance['excerpt_lenght'] = (int) $new_instance['excerpt_lenght'];
    return $instance;
  }
 
	public function does_post_exists( $id ) {
		return is_string( get_post_status( $id ) );
	}
 
	/*******************************************************************
	 * 
	 * The function below come from here: 
	 * http://fullrefresh.com/2013/08/02/getting-a-wp-post-excerpt-outside-the-loop-updated/
	 * 
	 * ****************************************************************/
 
	public function fr_excerpt_by_id($post_id, $excerpt_length = 35, $line_breaks = TRUE){
		$the_post = get_post($post_id); //Gets post ID
		$the_excerpt = $the_post->post_excerpt ? $the_post->post_excerpt : $the_post->post_content; //Gets post_excerpt or post_content to be used as a basis for the excerpt
		$the_excerpt = apply_filters('the_excerpt', $the_excerpt);
		$the_excerpt = $line_breaks ? strip_tags(strip_shortcodes($the_excerpt), '<p><br>') : strip_tags(strip_shortcodes($the_excerpt)); //Strips tags and imagesidW2rTuV
		$words = explode(' ', $the_excerpt, $excerpt_length + 1);
		if(count($words) > $excerpt_length) :
		  array_pop($words);
		  array_push($words, '…');
		  $the_excerpt = implode(' ', $words);
		  $the_excerpt = $line_breaks ? $the_excerpt . '</p>' : $the_excerpt;
		endif;
		$the_excerpt = trim($the_excerpt);
		return $the_excerpt;
	}
 
}
 
function ms_page_link_widget_plugin() {
    register_widget( "MS_Page_link" );
}
add_action( 'widgets_init', 'ms_page_link_widget_plugin' );
 
/**
 * Register text domain for localization.
 */
function ms_page_link_textdomain() {
	load_plugin_textdomain( 'ms-pagelink', false, dirname( plugin_basename( __FILE__ ) ) . '/lang' );
}
add_action( 'plugins_loaded', 'ms_page_link_textdomain' );
 
?>

Infine il plugin è predisposto per le traduzioni, ed è già tradotto in inglese (default) e in italiano. E’ possibile aggiungere altre traduzioni semplicemente aggiungendo il file della lingua nella cartella /lang all’interno della directory del plugin.

Download: http://www.spadamar.com/files/MS_Page_link/MS_Page_link.zip

 

WordPress: una classe PHP esterna per importare nei post da un array di dati

importWPHo scritto questa classe PHP per sopperire all’esigenza di importare dati provenienti da altri CMS in WordPress. Sebbene esistano diversi tool di importazione dai più diffusi CMS in WordPress, questi sono difficilmente adattabili a CMS proprietari oppure semplicemente per importare dati da archivi CSV.

Questa classe consente inoltre di creare, utilizzando semplicemente i post e le categorie di WordPress, un catalogo di prodotti che non abbia l’esigenza di un carrello della spesa.

La classe, sebbene includa tutte le funzioni di WordPress, è strutturata come elemento separato e non come plugin. Questo garantisce una maggior flessibilità di utilizzo e non lascia alcuna traccia una volta rimossa. E’ necessario però utilizzarla con accortezza e proteggere l’accesso agli script che la utilizzano, altrimenti chiunque potrebbe scrivere sul database.

Come si utilizza

Per un utilizzo semplificato è sufficiente avere un array contente per ciascuna riga solo il titolo del post e la descrizione. Facciamo un esempio:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
require_once("ImportPostWp.class.php");
 
$myData = array();
 
for ($i=1;$i<11;$i++) { 	$myData[] = array('post_title'=>'Nuovo titolo n.'.$i,
                          'post_content'=>'Nuova descrizione del post '.$i
                         );
 }
$obj = new ImportPostWp($myData,"../wp");
$res = $obj->insert_posts();	//Inserisce nel DB tutti i posts dell'array utilizzando funzioni native di WP
echo "\n
Record inseriti: ".$res;
echo "\n
Errori: ".implode(",",$obj->get_insert_errors());
echo "\n
Tempo trascorso: ".$obj->get_elapsed_time();

Gli inserimenti con il metodo insert_posts() sono necessariamente più lenti perché il metodo utilizza le funzioni native di WordPress che fanno un bel po’ di controlli di sicurezza sui contenuti, ma assicurano sempre il corretto inserimento. Nel caso in cui i post da inserire siano in numero minore di 200-300 è il metodo consigliato.

Questo è l’elenco di tutti i campi che è possibile inserire nell’array:

‘post_title’,’post_content’,’post_name’, ‘post_status’,’post_type’,’guid’,’post_excerpt’, ‘post_date’,’post_date_gmt’,’ping_status’, ‘comment_status’,’post_author’,’categories’

Alcuni di questi hanno valori particolari, per esempio ‘guid’, ‘post_date_gmt’ devono essere inseriti con dei valori specifici come il permalink e la data di Greenwich, quindi nel caso si voglia inserirli nell’array, è necessario che l’utente sappia bene cosa sta facendo. La classe calcola automaticamente questi valori. Per una spiegazione dettagliata sull’utilizzo di questi campi si rimanda alla documentazione di WordPress: https://codex.wordpress.org/Function_Reference/wp_insert_post

Per inserimenti pesanti (>500) è consigliabile usare il metodo raw_insert_posts() che utilizza l’oggetto $wpdb per eseguire query grezze SQL. Questo metodo è infinitamente più veloce. Io l’ho utilizzato per inserire circa 6000 post, in poco più di un minuto. C’è da notare che questo metodo non esegue particolari controlli di sicurezza. Inoltre il guid (ovvero il permalink all’articolo) che viene generato è compatibile solo con le impostazioni generali del permalink di WordPress impostate su: “Nome articolo”.

Documentazione:

La documentazione della classe è disponibile sia nel pacchetto compresso che online qui: http://www.spadamar.com/files/ImportPostWp/docs/ImportPostWp/ImportPostWp.class.html

e qui: http://www.spadamar.com/files/ImportPostWp/ImportPostWp.html

è possibile vedere il codice sorgente.

Download:

Il pacchetto compresso zip è disponibile qui: ImportPostWp.zip