">Doc

ADMIN FORM (ADFO) class

Per usare la classe ADFO scrivi admin_form\ADFO::function_name(); oppure

use admin_form\ADFO as ADFO;
ADFO::function_name();


ADFO::get_list($dbp_id, $only_table = false, $params=[], $prefix = "")

Carica una lista da un id e ne ritorna l'html.

Parameters

Return

Html

ADFO::get_single($dbp_id, $ids)

Ritorna l'html di un singolo record.

Parameters

Return

Html

ADFO::get_total($dbp_id, $filter = false)

Carica una lista da un id e calcola il totale degli elementi.

Parameters

Return

Int, -1 se non riesce a fare il conto

ADFO::get_lists_names()

Carica tutte le liste dbp

Return

Array

get_list_columns($dbp_id, $searchable = true, $extend = false)

Estrae l'elenco delle colonne di una lista.

Parameters

Return

ADFO_list_setting[]|array

ADFO::get_primaries_id($dbp_id)

Ritorna l'elenco delle chiavi primarie di una lista. I campi estratti sono gli alias!

Parameters

Return

@return array [table=>primary_name, ...]

ADFO::get_data($dbp_id, $return = "items", $add_where = null, $limit = null, $order_field = null, $order="ASC", $raw_data = false)

Ritornano i dati o il model di una lista

Parameters

La differenza tra $return = "raw" e $raw_data = true è che con $return = $raw vengono estratti tutti i dati delle tabelle interessate, mentre con $raw_data = true vengono estratti sempre i dati grezzi, ma solo delle colonne estratte dalla query.

Return

Mixed

ADFO::get_detail($dbp_id, $dbp_ids, $raw_data = true)

Ritorna i dati di un singolo record non modificato dalle impostazioni della lista. Questi dati possono essere passati a save_data dopo essere stati modificati per essere salvati.

Parameters

Example

Apre un record, lo modifica e lo risalva

use admin_form\ADFO as ADFO;
$list_id = 'insert_the_id_of_your_list';
$record_id = 'insert_the_id_of_a_record';
$item = ADFO::get_detail($list_id, $record_id);
$item->my_column = "new_value";
$ris = ADFO::save_data($list_id, $item);

Return

\stdClass|false

ADFO::get_clone_detail($dbp_id, $dbp_ids)

Ritorna i dati di un singolo record non modificato dalle impostazioni della lista. Questi dati possono essere passati a save_data dopo essere stati modificati per generare un nuovo record a partire dai dati di un altro record. A differenza di get_detail, clone_detail rimuove eventuali chiavi primarie e campi calcolati dai risultati estratti.

Parameters

Example

Clona un record

use admin_form\ADFO as ADFO;
$list_id = 'insert_the_id_of_your_list';
$record_id = 'insert_the_id_of_a_record';
$item = ADFO::get_clone_detail($list_id, $record_id);
$ris = ADFO::save_data($list_id, $item);

Return

\stdClass|false

ADFO::save_data($dbp_id, $data)

Salva i dati di una o più righe in una lista.

Parameters

Example

Crea un record

use admin_form\ADFO as ADFO;
$list_id = 'insert_the_id_of_your_list';
$item = (object)['my_column'=>'val'];
$ris = ADFO::save_data($list_id, $item);

Se tutti i campi sono vuoti (e sono tutti configurati) rimuove il record

use admin_form\ADFO as ADFO;
$item = ADFO::get_detail('77', 5);
foreach ($item as $k=>&$i) {
    // if primary key == "dbp_id"
    if ($k == "dbp_id") continue;
    $i = '';
}
// remove record 5
$ris = ADFO::save_data('77', $item);

Return

Return

array

ADFO::render($dbp_id, $mode)

Restituisce la classe ADFO_render_list

Parameters

Return

ADFO_render_list

Example

$list =  admin_form\ADFO::render(6, 'get'); // ($list_id:int, $mode:string); $mode is optional
$list->set_color('pink'); // Cambia il colore della lista rispetto a quello scelto 
$list->table("", false); // (custom_class:string, table_sort:bool)
$list->search(false); // optional (show_button:bool)
$list->single_field_search('column_name'); // aggiunge un campo di testo per ricercare in una singola colonna 
$list->submit(); // Aggiunge i bottoni per la ricerca 
$list->pagination('select');
$list->end(); // Required!

ADFO::draw_export_btn($dbp_id, $title, $format, $btn_class)

Stampa un link per l'export dei dati

Parameters

  • $dbp_id
    (integer) L'id della lista
  • $title
    (string) il testo del bottone
  • $format
    (string) csv/sql
  • $btn_class
    (string) la classe per modificare la grafica
  • Return

    Void

    Example

            // stampa il link per scaricare la lista $id.
            ADFO::draw_export_btn($dbp_id);
        

    ADFO::get_ids_value_from_list($dbp_id, $row, $return = 'string'

    Data una riga di un elenco di dati ($row) ritorna l'id o gli id per estrarre i dettagli del record. La versione string è usata nei link.

    Parameters

  • $dbp_id
    (integer) L'id della lista
  • $row
    (Object) un singolo record di una lista
  • $return
    (string) string|array|object
  • Return

    Mixed

    Example

      // Genera il link per un popup
        $id = ADFO::get_ids_value_from_list($dbp_id, $row);
        popup link'); ?>

    Template engine

    set get variable

        <?php 
            PinaCode::set_var("myvar","foobar"); 
            echo PinaCode::get_var("myvar","default"); 
        ?>
        

    Execute shortcode

        <?php 
            PinaCode::execute_shortcode('...'); 
        ?>
        

    Ritorna il risultato di un'espressione matematica o logica

        <?php 
            PinaCode::math_and_logic('3 > 6'); 
        ?>
        

    Set a new function

        function pinacode_fn_hello_world($short_code_name, $attributes) {
        PinaCode::set_var('global.search_container.status', 'open');
        return $string;	
    
        }
        pinacode_set_functions('hello_world', 'pinacode_fn_hello_world');
        

    Set a new attributes

        function pinacode_attr_fn_new_upper($gvalue, $param, $shortcode_obj) {
    		if (is_string($gvalue)) {
    			$gvalue = strtoupper($gvalue);
    		}
    		return $gvalue;
    	}
        pinacode_set_attribute(['new_upper'], 'pinacode_attr_fn_new_upper');