',
__('You are not allowed to view the submission log.', WPGFORM_I18N_DOMAIN)));
}
/*************************** LOAD THE BASE CLASS *******************************
*******************************************************************************
* The WP_List_Table class isn't automatically available to plugins, so we need
* to check if it's available and load it if necessary.
*/
if(!class_exists('WP_List_Table')){
require_once( ABSPATH . 'wp-admin/includes/class-wp-list-table.php' );
}
/************************** CREATE A PACKAGE CLASS *****************************
*******************************************************************************
* Create a new list table package that extends the core WP_List_Table class.
* WP_List_Table contains most of the framework for generating the table, but we
* need to define and override some methods so that our data can be displayed
* exactly the way we need it to be.
*
* To display this example on a page, you will first need to instantiate the class,
* then call $yourInstance->prepare_items() to handle any data manipulation, then
* finally call $yourInstance->display() to render the table to the page.
*
*/
class wpGForms_List_Table extends WP_List_Table {
/** ************************************************************************
* REQUIRED. Set up a constructor that references the parent constructor. We
* use the parent reference to set some default configs.
***************************************************************************/
function __construct() {
global $status, $page;
//Set parent defaults
parent::__construct( array(
'singular' => 'form', //singular name of the listed records
'plural' => 'forms', //plural name of the listed records
'ajax' => false //does this table support ajax?
) );
}
/** ************************************************************************
* Recommended. This method is called when the parent class can't find a method
* specifically build for a given column. Generally, it's recommended to include
* one method for each column you want to render, keeping your package class
* neat and organized. For example, if the class needs to process a column
* named 'last_name', it would first see if a method named $this->column_last_name()
* exists - if it does, that method will be used. If it doesn't, this one will
* be used. Generally, you should try to use custom column methods as much as
* possible.
*
* Since we have defined a column_last_name() method later on, this method doesn't
* need to concern itself with any column with a name of 'last_name'. Instead, it
* needs to handle everything else.
*
* For more detailed insight into how columns are handled, take a look at
* WP_List_Table::single_row_columns()
*
* @param array $item A singular item (one full row's worth of data)
* @param array $column_name The name/slug of the column to be processed
* @return string Text or HTML to be placed inside the column
**************************************************************************/
function column_default($item, $column_name) {
switch($column_name){
case 'timestamp':
case 'url':
case 'remote_addr':
case 'remote_host':
case 'http_referer':
case 'http_user_agent':
case 'form':
case 'post_id':
return $item->$column_name;
default:
return print_r($item,true); //Show the whole array for troubleshooting purposes
}
}
/** ************************************************************************
* Recommended. This is a custom column method and is responsible for what
* is rendered in any column with a name/slug of 'last_name'. Every time the class
* needs to render a column, it first looks for a method named
* column_{$column_last_name} - if it exists, that method is run. If it doesn't
* exist, column_default() is called instead.
*
* This example also illustrates how to implement rollover actions. Actions
* should be an associative array formatted as 'slug'=>'link html' - and you
* will need to generate the URLs yourself. You could even ensure the links
*
*
* @see WP_List_Table::single_row_columns()
* @param array $item A singular item (one full row's worth of data)
* @return string Text to be placed inside the column
(last_name only)
**************************************************************************/
function column_timestamp($item) {
//Build row actions
$actions = array(
// 'edit' => sprintf('Edit User Profile',
// get_admin_url(), 'user-edit.php?user_id=',$item->ID),
'delete' => sprintf('Delete Log Entry',
get_admin_url(), 'edit.php?post_type=' . WPGFORM_CPT_FORM .
'&page=wpgform-entry-log-page&action=delete&form=', $item->form),
);
//Return the last_name contents
return sprintf('%1$s (id:%2$s)%3$s',
/*$1%s*/ $item->timestamp,
/*$2%s*/ $item->form,
/*$3%s*/ $this->row_actions($actions)
);
}
/** ************************************************************************
* REQUIRED if displaying checkboxes or using bulk actions! The 'cb' column
* is given special treatment when columns are processed. It ALWAYS needs to
* have it's own method.
*
* @see WP_List_Table::single_row_columns()
* @param array $item A singular item (one full row's worth of data)
* @return string Text to be placed inside the column
(movie title only)
**************************************************************************/
function column_cb($item){
return sprintf(
'',
/*$1%s*/ $this->_args['singular'], //Let's simply repurpose the table's singular label ("last_name")
/*$2%s*/ $item->form //The value of the checkbox should be the record's id
);
}
/** ************************************************************************
* REQUIRED! This method dictates the table's columns and titles. This should
* return an array where the key is the column slug (and class) and the value
* is the column's title text. If you need a checkbox for bulk actions, refer
* to the $columns array below.
*
* The 'cb' column is treated differently than the rest. If including a checkbox
* column in your table you must create a column_cb() method. If you don't need
* bulk actions or checkboxes, simply leave the 'cb' entry out of your array.
*
* @see WP_List_Table::::single_row_columns()
* @return array An associative array containing column information: 'slugs'=>'Visible Titles'
**************************************************************************/
function get_columns(){
$columns = array(
'cb' => '', //Render a checkbox instead of text
'timestamp' => __('Timestamp', WPGFORM_I18N_DOMAIN),
'url' => __('URL', WPGFORM_I18N_DOMAIN),
'remote_addr' => __('Remote Addr', WPGFORM_I18N_DOMAIN),
'remote_host' => __('Remote Host', WPGFORM_I18N_DOMAIN),
'http_referer' => __('HTTP Refer', WPGFORM_I18N_DOMAIN),
'http_user_agent' => __('HTTP User Agent', WPGFORM_I18N_DOMAIN),
//'form' => __('wpGForm Id', WPGFORM_I18N_DOMAIN),
//'post_id' => __('Post Id', WPGFORM_I18N_DOMAIN)
);
return $columns;
}
/** ************************************************************************
* Optional. If you want one or more columns to be sortable (ASC/DESC toggle),
* you will need to register it here. This should return an array where the
* key is the column that needs to be sortable, and the value is db column to
* sort by. Often, the key and value will be the same, but this is not always
* the case (as the value is a column name from the database, not the list table).
*
* This method merely defines which columns should be sortable and makes them
* clickable - it does not handle the actual sorting. You still need to detect
* the ORDERBY and ORDER querystring variables within prepare_items() and sort
* your data accordingly (usually by modifying your query).
*
* @return array An associative array containing all the columns that should be sortable: 'slugs'=>array('data_values',bool)
**************************************************************************/
function get_sortable_columns() {
$sortable_columns = array(
'timestamp' => array('timestamp',true), //true means its already sorted
'url' => array('url',false),
'remote_addr' => array('remote_addr',false),
'remote_host' => array('remote_host',false),
'http_referer' => array('http_referer',false),
'http_user_agent' => array('http_user_agent',false),
//'form' => array('form',false),
//'post_id' => array('post_id',false)
);
return $sortable_columns;
}
/** ************************************************************************
* Optional. If you need to include bulk actions in your list table, this is
* the place to define them. Bulk actions are an associative array in the format
* 'slug'=>'Visible Title'
*
* If this method returns an empty value, no bulk action will be rendered. If
* you specify any bulk actions, the bulk actions box will be rendered with
* the table automatically on display().
*
* Also note that list tables are not automatically wrapped in