# Requisiti minimi per Software Licensing Software Licensing 3.8 ha introdotto la possibilità di impostare requisiti minimi di piattaforma per i prodotti. Se un cliente non soddisfa tali requisiti, non riceverà aggiornamenti automatici tramite l'API. - [Prerequisiti API](#prerequisites) - [Configurazione dei requisiti per un prodotto](#configuring-requirements) - [Aggiunta di requisiti personalizzati](#custom-requirements) Prerequisiti API ----------------- Affinché questa funzionalità funzioni correttamente, le versioni delle piattaforme del cliente devono essere inviate insieme alla richiesta API che verifica la presenza di un aggiornamento. Se stai utilizzando [il nostro plugin updater](https://easydigitaldownloads.com/docs/software-licensing-updater-implementation-for-wordpress-plugins/), ciò significa che il tuo prodotto deve includere la versione 1.9 o successiva del file di classe `EDD_SL_Plugin_Updater`. Se stai utilizzando [il nostro theme updater](https://easydigitaldownloads.com/docs/software-licensing-updater-implementation-for-wordpress-themes/), il tuo prodotto deve includere la versione 1.2 o successiva. Se hai creato un'integrazione personalizzata, devi assicurarti di includere "php\_version" e "wp\_version" nella tua richiesta API. Consulta la nostra [documentazione API](https://easydigitaldownloads.com/docs/software-licensing-api/) per maggiori dettagli. Se il sito di un cliente non include la/le versione/i della piattaforma nella richiesta API, tali requisiti non verranno verificati e l'utente potrebbe comunque ricevere l'aggiornamento. Configurazione dei requisiti per un prodotto -------------------------------------- Per configurare i requisiti di un prodotto, modifica il prodotto tramite Download > Modifica. Nella barra laterale destra, cerca una metabox chiamata "Requisiti di download". Ha questo aspetto: Inserisci semplicemente le tue versioni minime richieste e salva. Le versioni lasciate vuote non verranno verificate né richieste. Aggiunta di requisiti personalizzati -------------------------- Per impostazione predefinita, Software Licensing supporta le versioni PHP e WordPress, sebbene le tue dipendenze possano essere aggiunte con del codice personalizzato. Sono necessari due passaggi: **1. Aggiungi la tua dipendenza alla metabox** Aggiungere una nuova dipendenza si fa con un semplice filtro come questo, che deve essere aggiunto al tuo sito: ``` add_filter( 'edd_sl_platforms', function( $platforms ) { $platforms['your-platform-id'] = 'Your Platform Display Name'; return $platforms; } ); ``` Sostituisci `your-platform-id` con una versione univoca e compatibile con slug del nome della tua dipendenza e sostituisci `Your Platform Display Name` con la versione visualizzabile. Ecco un esempio di aggiunta di Easy Digital Downloads come requisito: ``` add_filter( 'edd_sl_platforms', function( $platforms ) { $platforms['easy-digital-downloads'] = 'Easy Digital Downloads'; return $platforms; } ); ``` Una volta aggiunto, la tua piattaforma apparirà nella metabox: **2. Includi la versione della dipendenza nella tua richiesta API** Quando verifichi la presenza di un nuovo aggiornamento tramite API (all'interno del tuo prodotto), devi inviare il numero di versione corrente della dipendenza nella richiesta API. Per farlo, devi semplicemente aggiungere un nuovo argomento: `{your platform ID}_version`. Una richiesta di controllo versione normalmente appare così: ``` https://YOURSITE.com/?edd_action=get_version&item_id=8&license=cc22c1ec86304b36883440e2e84cddff&url=https://licensedsite.com ``` Ma con il nostro nuovo argomento, apparirebbe così: ``` https://YOURSITE.com/?edd_action=get_version&item_id=8&license=cc22c1ec86304b36883440e2e84cddff&url=https://licensedsite.com&easy-digital-downloads_version=1.0 ``` Nota l'aggiunta di `&easy-digital-downloads_version=1.0` alla fine. Se stai utilizzando un updater personalizzato, puoi aggiungere il nuovo argomento direttamente ai parametri API inviati con la richiesta: ``` $api_params = array( 'edd_action' => 'get_version', 'license' => ! empty( $data['license'] ) ? $data['license'] : '', 'item_name' => isset( $data['item_name'] ) ? $data['item_name'] : false, 'item_id' => isset( $data['item_id'] ) ? $data['item_id'] : false, 'version' => $this->version, 'slug' => $data['slug'], 'author' => $data['author'], 'url' => home_url(), 'beta' => ! empty( $data['beta'] ), 'php_version' => phpversion(), 'wp_version' => get_bloginfo( 'version' ), 'easy-digital-downloads_version' => defined( 'EDD_VERSION' ) ? EDD_VERSION : '', // current version number ); ``` Se stai utilizzando la nostra classe di updater del plugin (versione 1.9 o successiva), puoi aggiungere questo argomento alla richiesta API utilizzando un filtro. Questo filtro deve far parte del tuo plugin, poiché viene eseguito sui siti dei tuoi clienti: ``` add_filter( 'edd_sl_plugin_updater_api_params', function( $api_params, $api_data, $plugin_file ) { /* * Assicurati che $plugin_file corrisponda al percorso del file del tuo plugin. Dovresti avere una costante per questo * o puoi usare __FILE__ se questo codice va nel file principale del tuo plugin. */ if ( __FILE__ === $plugin_file ) { // Recupera dinamicamente il numero di versione corrente. $api_params['easy-digital-downloads_version'] = defined( 'EDD_VERSION' ) ? EDD_VERSION : ''; } return $api_params; }, 10, 3 ); ``` Assicurati di sostituire `easy-digital-downloads` con l'ID univoco che hai scelto per la tua dipendenza e `defined( 'EDD_VERSION' ) ? EDD_VERSION : ''` con il numero di versione corrente. Questo valore deve poter essere recuperato dinamicamente dal sito del cliente.