Blog Archives - Un Moscerino Nel Web

19 Febbraio 2019

Classi php reference, clone, duplicate

È molto interessante notare la differenza tra clonazione, duplicazione e referenza ad una classe. In questo piccolo articolo ci chiariremo le idee in tal senso.

Vi invito ad eseguire lo script che segue in un file .php

// Classe sorgente
$class = new stdClass();
// Assegnazione
$a = $class;
// Referenza<br>$b = &amp;$class;
// Clonazione<br>$c = clone $class;
// Creo una proprietà per $class e gli assegno un valore.
$class-&gt;roba = 'roba';
// Dump delle differenze
var_dump($a);
var_dump($b);
var_dump($c);

// Classe sorgente

$class = new stdClass();

// Assegnazione

$a = $class;

// Referenza<br>$b = &$class;

// Clonazione<br>$c = clone $class;

// Creo una proprietà per $class e gli assegno un valore.

$class->roba = 'roba';

// Dump delle differenze

var_dump($a);

var_dump($b);

var_dump($c);

Il risultato che io ottengo è il seguente:

object(stdClass)#1 (1) {
  ["roba"]=>
  string(4) "roba"
}
object(stdClass)#1 (1) {
  ["roba"]=>
  string(4) "roba"
}
object(stdClass)#2 (0) {
}

object(stdClass)#1 (1) {

["roba"]=>

string(4) "roba"

}

object(stdClass)#1 (1) {

["roba"]=>

string(4) "roba"

}

object(stdClass)#2 (0) {

}

Come dobbiamo interpretare questo risultato?

La questione è molto semplice come possiamo vedere:

$class è la classe sorgente;
$a rappresenta una copia di $class ottenuta per assegnazione (tramite l’operatore di assegnazione ‘=’);
$b referenzia $a, significa che è un puntatore alla risorsa, non un suo duplicato;
$c è invece un clone della classe.

Quello che vediamo nei 3 var_dump è:

che $a e $b si comportano allo stesso modo e dal numero identificativo della risorsa (quello con il cancelletto) capiamo che si tratta della stessa cosa (ovvero di puntatori a $class);
$c invece rappresenta una nuova istanza della classe (stdClass) ottenuta per clonazione.

8 Gennaio 20198 Gennaio 2019

Translate a Drupal 7 custom module via l10n_update

It is really a big deal to manage translations of custom module in Drupal 7 expecially if you have a multisite installation.

Problem

We want use a .po file to translate a custom module programmatically, i.e. without forcing a redactor to do dangerous manual operations.

Furthermore we want have our module always accompained by its translations.

Solution

First of all we need to have l10n_update module installed.

Than we can declare the hook “l10n_update_projects_alter” which allow to set a remote path where the .po file is hosted.

Normally the path should be a remote, indipendent one, but in most cases we would like to have the .po file inside the website itself (i.e. not a separeted environment).

Take a look to the code below in which I declare a .po file that is in the module folder, in particular in “translations” subfolder.

As you can see the file name contains the parameter %language. In this case the filename would be ModuleName.LanguageCode.po.

/**
 * Alter the list of project to be updated by Localization Update.
 *
 * L10n_update uses the same list of projects as update module. Using this hook
 * the list can be altered. This hook is typically used to alter the following
 * values from the .info file:
 *  - interface translation project
 *  - l10n path.
 *
 * @param array $projects
 *   Array of projects.
 */
function my_module_name_l10n_update_projects_alter(array &$projects) {
  // Setting module name.
  $name = 'my_module_name';
  // Setting the path of .po files.
  $pathToModule = drupal_get_path('module', $name);
  $pathToPo = $pathToModule . '/translations/';
  $poFileName = $name . '.%language.po';
  // Getting url to po
  $urlToPoFolder = file_create_url($pathToPo);
  $urlToPoFile = $urlToPoFolder . $poFileName;

  /**
   * In case of S3 filesystem uncomment the code below.
   */
  // Instead of the default ftp.drupal.org we use the file system of the test
  // instance to simulate a remote file location.
  //$wrapper = file_stream_wrapper_get_instance_by_uri('public://');
  //$remote_url = $wrapper->getExternalUrl() . '/remote/';

  // With this hook it is also possible to add a new project which does not
  // exist as a real module or theme project but is treated by the localization
  // update module as one. The below data is the minimum to be specified.
  // As in the previous example the 'l10n path' element is optional.
  $projects[$name] = array(
    'project_type'  => 'module',
    'name' => $name,
    'info' => array(
      'name' => 'My Module name',
      'interface translation project' => $name,
      'version' => '7.x-1.0',
      'core' => '7.x',
      'l10n path' => $urlToPoFile,
    ),
  );
}

/**

* Alter the list of project to be updated by Localization Update.

* L10n_update uses the same list of projects as update module. Using this hook

* the list can be altered. This hook is typically used to alter the following

* values from the .info file:

* - interface translation project

* - l10n path.

* @param array $projects

* Array of projects.

function my_module_name_l10n_update_projects_alter(array &$projects) {

// Setting module name.

$name = 'my_module_name';

// Setting the path of .po files.

$pathToModule = drupal_get_path('module', $name);

$pathToPo = $pathToModule . '/translations/';

$poFileName = $name . '.%language.po';

// Getting url to po

$urlToPoFolder = file_create_url($pathToPo);

$urlToPoFile = $urlToPoFolder . $poFileName;

/**

* In case of S3 filesystem uncomment the code below.

// Instead of the default ftp.drupal.org we use the file system of the test

// instance to simulate a remote file location.

//$wrapper = file_stream_wrapper_get_instance_by_uri('public://');

//$remote_url = $wrapper->getExternalUrl() . '/remote/';

// With this hook it is also possible to add a new project which does not

// exist as a real module or theme project but is treated by the localization

// update module as one. The below data is the minimum to be specified.

// As in the previous example the 'l10n path' element is optional.

$projects[$name] = array(

'project_type' => 'module',

'name' => $name,

'info' => array(

'name' => 'My Module name',

'interface translation project' => $name,

'version' => '7.x-1.0',

'core' => '7.x',

'l10n path' => $urlToPoFile,

);

}

Furthermore with the following snippet, I have manually (i.e. programmatically) forced the module to update its translations.

// Getting dependencies.
module_load_include('inc','l10n_update','l10n_update.translation');
module_load_include('inc','l10n_update','l10n_update.fetch');


$projects = ['my_module_name'];


$options = _l10n_update_default_update_options();
$options['customized'] = true;
$options['use_remote'] = true;
$options['overwrite_options']['customized'] = true;

l10n_update_clear_status();
$batch = l10n_update_batch_update_build($projects, [], $options);
batch_set($batch);

// Getting dependencies.

module_load_include('inc','l10n_update','l10n_update.translation');

module_load_include('inc','l10n_update','l10n_update.fetch');

$projects = ['my_module_name'];

$options = _l10n_update_default_update_options();

$options['customized'] = true;

$options['use_remote'] = true;

$options['overwrite_options']['customized'] = true;

l10n_update_clear_status();

$batch = l10n_update_batch_update_build($projects, [], $options);

batch_set($batch);

The .po files have been extracted thanks to Translation Template Extractor.

9 Ottobre 2018

Drupal 8 views ajax manual refreshing does not work properly

Interviewer: Drupal 8 is amazing … isn’t it?

Angry me: No, it’s not!

One of the problems we have spent lot’s of energies on is related to Drupal 8 views.
As you probably know the contrib module views has been integrated as a core module in this version 8 of Drupal.

Eventough there’s a nice page with documentation on D8 views, as a Drupal developers we know we can not fully rely on it to get rid of problems.

The problem

When a view is printed into a webpage as block or in a shape different of “page” display type, you can not have ajax features working properly on it, furthermore you are also not able to manually (via javascript) refresh it (triggering “RefreshView”).

If you watch what happen in a standard views with page as display type, and then start to playing “find the difference” with the other display types, you will (soon or later) notice that lot’s Javascript files views-ajax related, are not even included into the DOM!

But, what is happening?

For some reason, after hours, we have understand that even if you flag the checkbox to “use ajax” you are not able to get

Drupal.views.instances

1	Drupal.views.instances

in browser console and neither, of course, the ajax views behavior.

The solution

When you are invoking the view do not forget to invoke “preview” method too, because it is responsible to prepare the view as desired.

<?php

// Getting a view.
$view = Views::getView('view_name');
// Invoking preview to pre and post execute the view.
$view->preview('view_display_type');
// Getting the view (WITH AJAX WORKING! YEAH!!)
$sample_reception = $view->render();

?>

<?php

// Getting a view.

$view = Views::getView('view_name');

// Invoking preview to pre and post execute the view.

$view->preview('view_display_type');

// Getting the view (WITH AJAX WORKING! YEAH!!)

$sample_reception = $view->render();

We found no documentation on the web, so we assume this article will be useful for some Drupal information thirsty developer.

Thanks to Luca Rossi that achieved the solution.

24 Luglio 20188 Gennaio 2019

jQuery Once: Drupal 8 vs Drupal 7

utilities:
  version: 1.x
  js:
    js/throbber.js: {}
  dependencies:
  - core/drupalSettings
  - core/jquery
  - core/jquery.once

utilities:

version: 1.x

js:

js/throbber.js: {}

dependencies:

- core/drupalSettings

- core/jquery

- core/jquery.once

Chi ha avuto modo di cimentarsi nella stesura di qualche riga di codice JS in Drupal 8 si sarà sicuramente imbattuto in un problema, quello di jQuery once che non funziona a dovere, o almeno così pare.

Cosa è successo?

In primis c’è da capire qual è la versione di jQuery utilizzata.

Drupal 7

In tal senso con il modulo contrib jQuery update di Drupal 7 era possibile passare dalla versione 1.4 di jQuery ad una versione superiore a scelta (oggi arrivata alla 1.10) e che il modulo non è più disponibile in Drupal 8.

In Drupal 7 avremmo fatto una cosa del genere:

# source: https://www.drupal.org/node/2457769
/**
 * Attach my behavior to the .mybehavior elements.
 */
Drupal.behaviors.mybehavior = {
  attach: function(context) {
    // Set the initial state of the toolbar.
    $('.mybehavior', context).once('mybehavior', function() {
      // Do something to the elements.
      $(this).css('background-color', 'red');
    });
  }
};

# source: https://www.drupal.org/node/2457769

/**

* Attach my behavior to the .mybehavior elements.

Drupal.behaviors.mybehavior = {

attach: function(context) {

// Set the initial state of the toolbar.

$('.mybehavior', context).once('mybehavior', function() {

// Do something to the elements.

$(this).css('background-color', 'red');

});

}

};

Drupal 8

In Drupal 8 la versione di jQuery è la 3.2.1 (questo al 24/07/2018 quando è appena uscita l’alpha di Drupal 8.6.0-alpha1; vedi immagine).

Quindi molto più avanzata rispetto a quella di Drupal 7.

Questo ha fatto sì che il modo di invocare determinate funzioni (come il once) sia cambiato.

Come rilevato nel ticket aperto dalla community di Drupal c’è un problema di funzionamento con jQuery once che deve essere invocato in un altro modo, dopo che esso è stato aggiornato alla versione 2.0.

Ebbene tutto ciò è stato realizzato discusso, analizzato e risolto in un ticket sulla community, questo: https://www.drupal.org/node/2457769.

Per comodità riporto di seguito l’esempio ivi riportato:

# source: https://www.drupal.org/node/2457769
/**
 * Attach my behavior to the .mybehavior elements.
 */
Drupal.behaviors.mybehavior = {
  attach: function(context) {
    // Set the initial state of the toolbar.
    $(context).find('[data-mybehavior]').once('mybehavior').each(function() {
      // Do something to the elements.
      $(this).css('background-color', 'red');
    });
  }
};

# source: https://www.drupal.org/node/2457769

/**

* Attach my behavior to the .mybehavior elements.

Drupal.behaviors.mybehavior = {

attach: function(context) {

// Set the initial state of the toolbar.

$(context).find('[data-mybehavior]').once('mybehavior').each(function() {

// Do something to the elements.

$(this).css('background-color', 'red');

});

}

};

Come è possibile vedere adesso il once si ottiene in maniera sequenziale, senza gli innesti che erano necessari qualche versione fa.

EDIT 08/01/2019

Per evitare che l’utente anonimo abbia problemi con jQuery Once è necessario includere quanto segue, tra le dipendenze di un modulo che usa jQuery Once.

Riferimento: https://www.drupal.org/project/ultimenu/issues/2562829

5 Luglio 20185 Luglio 2018

Drupal 7 campi condizionali nei form con gli states

Oggi voglio presentarvi gli states degli elementi di un form Drupal.

Il problema

Vogliamo per un motivo o per un altro nascondere selettivamente dei campi in determinate condizioni, senza scrivere dei JS da aggiungere al form, massimizzando la manutenibilità del codice.

Tutto questo è consentito dagli states degli elementi del form di Drupal che consentono di inserire una logica con stati e condizioni in grado ad esempio di nascondere un campo se una checkbox è flaggata oppure mostrare un campo e renderlo obbligatorio.

Esempio:

Poniamoci nel caso in cui abbiamo un modulo di inserimento (un form insomma) di richieste di supporto in cui abbiamo un campo di tipo select chiamato “Oggetto” con varie opzioni selezionabili. Una di queste opzioni è “Altro”, se “Altro” è selezionato allora bisogna mostrare un campo (normalmente nascosto) chiamato “oggetto altro”.

Un codice di questo tipo risolve assolve al compito:

$form['subject_other'] = array(
  '#states' => array(
    // Show the subject_other if subject value is other.
    'visible' => array(
      ':input[name="subject"]' => array('value' => 'other'),
    ),
    'required' => array(
      ':input[name="subject"]' => array('value' => 'other'),
    ),
  ),
);

$form['subject_other'] = array(

'#states' => array(

// Show the subject_other if subject value is other.

'visible' => array(

':input[name="subject"]' => array('value' => 'other'),

'required' => array(

':input[name="subject"]' => array('value' => 'other'),

);

Interessante analizzare la funzione drupal_process_states poiché essa mostra tutti gli stati e le condizioni possibili, che per comodità riporto qui sotto:

I possibili stati di un elemento (del form) sono:

enabled
disabled
required
optional
visible
invisible
checked
unchecked
expanded
collapsed

Le possibili condizioni (che su drupal.org chiama remote conditions) sono:

empty
filled
checked
unchecked
expanded
collapsed
value

Gli stati che seguono possono essere utilizzati sia come stati di un elemento (primo gruppo) sia come condizioni remote (secondo gruppo):

relevant
irrelevant
valid
invalid
touched
untouched
readwrite
readonly

Tuttavia il funzionamento di quest’ultimo gruppo di stati non è garantito in ogni scenario, poiché le funzionalità che ne derivano sono molto dipendenti dal browser dal quale vengono eseguite.

Dalla versione 7.14 di Drupal è anche possibile usare OR e XOR.

Spero di essere stato utile.

NOTA: Un discorso del tutto analogo può essere fatto per Drupal 8 che, sebbene abbia stravolto la maggior parte delle funzionalità di Drupal 7, implementa questa degli states degli elementi del form in maniera similare.

21 Giugno 2018

Drupal 8 creare link html da file id (fid)

Per i nostalgici di Drupal 7 che hanno provato disperatamente a districarsi tra le varie classi introdotte in Drupal 8, ebbene sappiate che:

per quello che può servire, godete della mia solidarietà
dopo varie peripezie sono riuscito ad ottenere un codice utile a generare il famigerato html

Ecco il codice di esempio testato su Drupal 8.5.x

use Drupal\file\Entity\File;
use Drupal\Core\Link;
use Drupal\Core\Url;

$fid = 123; // <- your file id here

$uri = File::load($fid)->getFileUri();
$url = Url::fromUri(file_create_url($uri));
$link = Link::fromTextAndUrl('somestring', $url);
$link = $link->toRenderable();

print render($link); // <- this is HTML!!! YEAH!

use Drupal\file\Entity\File;

use Drupal\Core\Link;

use Drupal\Core\Url;

$fid = 123; // <- your file id here

$uri = File::load($fid)->getFileUri();

$url = Url::fromUri(file_create_url($uri));

$link = Link::fromTextAndUrl('somestring', $url);

$link = $link->toRenderable();

print render($link); // <- this is HTML!!! YEAH!

spero che questo codice vi sia di aiuto.

Fatemi sapere, nei commenti, se questa cosa vi risolve il problema.

12 Aprile 2018

Email security check. Email violata? Controlla e provvedi subito!

Vi ricordate quando abbiamo parlato di come creare una password che vi garantisca un buon livello di sicurezza?
Ecco il link all’articolo http://www.unmoscerinonelweb.com/blog/password-sicura-sei-sicuro/ nel caso ve lo foste perso.

Rimane sempre una buona idea avere una password diversa per ogni account, perché? Semplice se qualche cracker (un hacker con cattive intenzioni) riuscisse a violare un sito dove siete registrati ed ottenere la vostra password allora avrebbe le porte della vostra privacy e della vostra sicurezza spalancate, con tanto di tappeto rosso.

Su questo sito potete scoprire se il vostro account email risulta essere stato violato assieme agli altri presenti su un sito dove siete registrati e quali sono i dati in pericolo.

Visitate haveibeenpwned.com scrivete il vostro indirizzo email e incrociate le dita.

Se ci sono problemi di sicurezza vi sarà mostrato un report di questo tipo:

Andate portale per portale e cambiate la password, inserendone una diversa per ogni sito/portale.

Buona fortuna.

PSSSS

Volete un modo per conservare le password indipendente e offline? Date un’occhiata a keepass.info.

3 Settembre 2017

File managed entire folder Drupal

Some information on managed and unmanaged files in Drupal

If a file is on a certain folder of the webserver within the Drupal folders it does not mean that Drupal knows it!

When Drupal “store” the presence of a certain file (i.e. public://myfile.pdf) it became a managed file.

You can add a file to managed with file_save_data function.

Luckly or unfortunaly a function that manage an entire directory of files, maybe in a recursive way, is not present in Drupal core.

How to import a folder of files to Drupal?

I create a script to this in a clean and easy way.

  $destination = 'public://path-to-folder';
  $regex = '/.*\.jpg$/'; // This will identify jpg files

  $paths = file_scan_directory($destination,$regex);
  foreach($paths as $path =&gt; $data){
    $realPath = drupal_realpath($path);
    $handle = fopen($realPath, 'r');
    $file = file_save_data($handle, $path, FILE_EXISTS_REPLACE);
    fclose($handle);
    if(!$file){
      dpm('ERROR');
    }
    else{
      dpm("YEAH!!");
      dpm($file);
    }
  }

$destination = 'public://path-to-folder';

$regex = '/.*\.jpg$/'; // This will identify jpg files

$paths = file_scan_directory($destination,$regex);

foreach($paths as $path => $data){

$realPath = drupal_realpath($path);

$handle = fopen($realPath, 'r');

$file = file_save_data($handle, $path, FILE_EXISTS_REPLACE);

fclose($handle);

if(!$file){

dpm('ERROR');

}

else{

dpm("YEAH!!");

dpm($file);

}

Note that dpm function is provided with a contrib module: Devel.

Hint

I have used this functionality to put lots of images in the media library (made with Media module) and make them available for redactors.

7 Giugno 20177 Giugno 2017

Drupal 7 blocks external frame due to X-Frame-Options

As documented (https://www.drupal.org/node/2735873) Drupal comunity removed the possibility to embedd a Drupal site into an external frame to avoid clickjacking.

The problem

Basically you can not put an external Drupal website into an iFrame anymore, if you try to embedd a website with X-Frame-Options restrictions you will get a browser console error stating something like this

because it set ‘X-Frame-Options’ to ‘sameorigin’

This behavior is obtained in drupal_deliver_html_page (in common.inc) in which it is checked what I show you below:

// By default, do not allow the site to be rendered in an iframe on another
// domain, but provide a variable to override this. If the code running for
// this page request already set the X-Frame-Options header earlier, don't
// overwrite it here.
$frame_options = variable_get('x_frame_options', 'SAMEORIGIN');
if ($frame_options && is_null(drupal_get_http_header('X-Frame-Options'))) {
  drupal_add_http_header('X-Frame-Options', $frame_options);
}

// By default, do not allow the site to be rendered in an iframe on another

// domain, but provide a variable to override this. If the code running for

// this page request already set the X-Frame-Options header earlier, don't

// overwrite it here.

$frame_options = variable_get('x_frame_options', 'SAMEORIGIN');

if ($frame_options && is_null(drupal_get_http_header('X-Frame-Options'))) {

drupal_add_http_header('X-Frame-Options', $frame_options);

}

To see your Drupal website displayed into a frame of an external website you must change X-Frame-Options (or remove it).

The solution

Although Drupal documentation (https://www.drupal.org/node/2735873) explains that you can remove the X-Frame-Options header via the page_alter, I discovered that under certain conditions this strategy does not work at all.

In my case I was able to surf the site from a Frame only if I was logged in with an active session.

To achieve a better solution, my suggestion is to modify the Drupal variable x_frame_options before the drupal_deliver_html_page is called.
I did this (and it works like charme) via page_delivery_callback_alter, where I set the variable to FALSE under certain satisfited conditions (i.e. the page is requested from a whitelist domain).

function MYMODULENAME_page_delivery_callback_alter(&$delivery_callback) {
  $domains = variable_get('ur_com_xframe_allowed',array('http://www.myalloweddomain.xxx/'));
  //removing frameset limitation for certain referrers
  if(in_array($_SERVER['HTTP_REFERER'],$domains)){
    //setting the variable to false in order to avoid a future setting of the header
    variable_set('x_frame_options', FALSE);
  } else {
    //default behavior
    variable_set('x_frame_options', 'SAMEORIGIN');
  }
}

function MYMODULENAME_page_delivery_callback_alter(&$delivery_callback) {

$domains = variable_get('ur_com_xframe_allowed',array('http://www.myalloweddomain.xxx/'));

//removing frameset limitation for certain referrers

if(in_array($_SERVER['HTTP_REFERER'],$domains)){

//setting the variable to false in order to avoid a future setting of the header

variable_set('x_frame_options', FALSE);

} else {

//default behavior

variable_set('x_frame_options', 'SAMEORIGIN');

}

Hope this help.

18 Gennaio 201720 Maggio 2017

Requisiti pubblicazione app su Android store

Di seguito una raccolta delle immagini e info necessarie a sottoporre un’app Android nell’Android store.

Occorrono i seguenti testi

Titolo (max 30 caratteri)
Descrizione breve (max 80 caratteri)
Descrizione completa (max 4000 caratteri)

Occorrono le seguenti immagini tenendo conto delle indicazioni di Google a riguardo, che riporto di seguito:

Predefinita: Italiano – it-IT
JPEG o PNG a 24 bit (non alfa). Lunghezza minima di qualsiasi lato: 320 px. Lunghezza massima di qualsiasi lato: 3840 px.
Sono richiesti almeno 2 screenshot totali. Massimo 8 screenshot per tipo. Trascina per riordinare o per cambiare tipo.

Tenuta presente questa condizione, bisogna produrre:

Icona ad alta risoluzione
Predefinita: Italiano – it-IT
512 x 512
PNG a 32 bit (con alfa)
Banner in primo piano
Predefinita: Italiano – it-IT
1024 l x 500 a
JPG o PNG a 24 bit (non alfa)
Immagine promozionale
Predefinita: Italiano – it-IT
180 l x 120 a
JPG o PNG a 24 bit (non alfa)
Banner TV
Predefinita: Italiano – it-IT
1280 l x 720 a
JPG o PNG a 24 bit (non alfa)

Semmai non lo sapessi con alfa si intende la trasparenza.

Inoltre sono da fornire queste ulteriori informazioni, alcune delle quali obbligatorie:

Video promozionale
Predefinita: Italiano – it-IT
Video di YouTube
Inserisci un URL
Tipo di applicazione (a scelta tra “applicazione” e “gioco”)
Categoria (a scelta in una lista)
Sito web
Email
Telefono
Link alla pagina relativa alla privacy

Terrò aggiornato il post con le novità.