Edit File by line
/home/zeestwma/richards.../wp-conte.../plugins/wpforms-.../src/Logger
File: ListTable.php
<?php
[0] Fix | Delete
[1] Fix | Delete
namespace WPForms\Logger;
[2] Fix | Delete
[3] Fix | Delete
if ( ! defined( 'ABSPATH' ) ) {
[4] Fix | Delete
exit;
[5] Fix | Delete
}
[6] Fix | Delete
[7] Fix | Delete
use WP_List_Table;
[8] Fix | Delete
[9] Fix | Delete
if ( ! class_exists( 'WP_List_Table' ) ) {
[10] Fix | Delete
require_once ABSPATH . 'wp-admin/includes/class-wp-list-table.php';
[11] Fix | Delete
}
[12] Fix | Delete
[13] Fix | Delete
/**
[14] Fix | Delete
* Class ListTable.
[15] Fix | Delete
*
[16] Fix | Delete
* @since 1.6.3
[17] Fix | Delete
*/
[18] Fix | Delete
class ListTable extends WP_List_Table {
[19] Fix | Delete
[20] Fix | Delete
/**
[21] Fix | Delete
* Record Query.
[22] Fix | Delete
*
[23] Fix | Delete
* @since 1.6.3
[24] Fix | Delete
*
[25] Fix | Delete
* @var Repository
[26] Fix | Delete
*/
[27] Fix | Delete
private $repository;
[28] Fix | Delete
[29] Fix | Delete
/**
[30] Fix | Delete
* ListTable constructor.
[31] Fix | Delete
*
[32] Fix | Delete
* @since 1.6.3
[33] Fix | Delete
*
[34] Fix | Delete
* @param Repository $repository Repository.
[35] Fix | Delete
*/
[36] Fix | Delete
public function __construct( $repository ) {
[37] Fix | Delete
[38] Fix | Delete
$this->repository = $repository;
[39] Fix | Delete
[40] Fix | Delete
parent::__construct(
[41] Fix | Delete
[
[42] Fix | Delete
'plural' => esc_html__( 'Logs', 'wpforms-lite' ),
[43] Fix | Delete
'singular' => esc_html__( 'Log', 'wpforms-lite' ),
[44] Fix | Delete
]
[45] Fix | Delete
);
[46] Fix | Delete
[47] Fix | Delete
$this->hooks();
[48] Fix | Delete
[49] Fix | Delete
add_screen_option(
[50] Fix | Delete
'per_page',
[51] Fix | Delete
[ 'default' => $this->get_items_per_page( $this->get_per_page_option_name() ) ]
[52] Fix | Delete
);
[53] Fix | Delete
set_screen_options();
[54] Fix | Delete
}
[55] Fix | Delete
[56] Fix | Delete
/**
[57] Fix | Delete
* Hooks.
[58] Fix | Delete
*
[59] Fix | Delete
* @since 1.7.5
[60] Fix | Delete
*/
[61] Fix | Delete
private function hooks() {
[62] Fix | Delete
[63] Fix | Delete
add_filter(
[64] Fix | Delete
'set_screen_option_' . $this->get_per_page_option_name(),
[65] Fix | Delete
[ $this, 'set_items_per_page_option' ],
[66] Fix | Delete
10,
[67] Fix | Delete
3
[68] Fix | Delete
);
[69] Fix | Delete
}
[70] Fix | Delete
[71] Fix | Delete
/**
[72] Fix | Delete
* Handles setting the items_per_page option for this screen.
[73] Fix | Delete
*
[74] Fix | Delete
* @since 1.7.5
[75] Fix | Delete
*
[76] Fix | Delete
* @param mixed $status Default false (to skip saving the current option).
[77] Fix | Delete
* @param string $option Screen option name.
[78] Fix | Delete
* @param int $value Screen option value.
[79] Fix | Delete
*
[80] Fix | Delete
* @return int
[81] Fix | Delete
* @noinspection PhpUnusedParameterInspection
[82] Fix | Delete
*/
[83] Fix | Delete
public function set_items_per_page_option( $status, $option, $value ) {
[84] Fix | Delete
[85] Fix | Delete
return $value;
[86] Fix | Delete
}
[87] Fix | Delete
[88] Fix | Delete
/**
[89] Fix | Delete
* Whether the table has items to display or not.
[90] Fix | Delete
*
[91] Fix | Delete
* @since 1.6.3
[92] Fix | Delete
*
[93] Fix | Delete
* @return bool
[94] Fix | Delete
*/
[95] Fix | Delete
public function has_items() {
[96] Fix | Delete
[97] Fix | Delete
// We can't use the empty function because it doesn't work with the Countable object.
[98] Fix | Delete
return (bool) count( $this->items );
[99] Fix | Delete
}
[100] Fix | Delete
[101] Fix | Delete
/**
[102] Fix | Delete
* Prepares the list of items for displaying.
[103] Fix | Delete
*
[104] Fix | Delete
* @since 1.6.3
[105] Fix | Delete
*/
[106] Fix | Delete
public function prepare_items() {
[107] Fix | Delete
[108] Fix | Delete
$offset = $this->get_items_offset();
[109] Fix | Delete
$search = $this->get_request_search_query();
[110] Fix | Delete
$types = $this->get_items_type();
[111] Fix | Delete
$per_page = $this->get_items_per_page( $this->get_per_page_option_name() );
[112] Fix | Delete
$this->items = $this->repository->records( $per_page, $offset, $search, $types );
[113] Fix | Delete
$total_items = $this->get_total();
[114] Fix | Delete
[115] Fix | Delete
$this->set_pagination_args(
[116] Fix | Delete
[
[117] Fix | Delete
'total_items' => $total_items,
[118] Fix | Delete
'per_page' => $per_page,
[119] Fix | Delete
'total_pages' => (int) ceil( $total_items / $per_page ),
[120] Fix | Delete
]
[121] Fix | Delete
);
[122] Fix | Delete
}
[123] Fix | Delete
[124] Fix | Delete
/**
[125] Fix | Delete
* Return the type of records.
[126] Fix | Delete
*
[127] Fix | Delete
* @since 1.6.3
[128] Fix | Delete
*
[129] Fix | Delete
* @return string
[130] Fix | Delete
*/
[131] Fix | Delete
private function get_items_type() {
[132] Fix | Delete
[133] Fix | Delete
return filter_input( INPUT_GET, 'log_type', FILTER_SANITIZE_FULL_SPECIAL_CHARS );
[134] Fix | Delete
}
[135] Fix | Delete
[136] Fix | Delete
/**
[137] Fix | Delete
* Return the number of items to offset/skip for this current view.
[138] Fix | Delete
*
[139] Fix | Delete
* @since 1.6.3
[140] Fix | Delete
*
[141] Fix | Delete
* @return int
[142] Fix | Delete
*/
[143] Fix | Delete
private function get_items_offset() {
[144] Fix | Delete
[145] Fix | Delete
return $this->get_items_per_page( $this->get_per_page_option_name() ) * ( $this->get_pagenum() - 1 );
[146] Fix | Delete
}
[147] Fix | Delete
[148] Fix | Delete
/**
[149] Fix | Delete
* Return the search filter for this request, if any.
[150] Fix | Delete
*
[151] Fix | Delete
* @since 1.6.3
[152] Fix | Delete
*
[153] Fix | Delete
* @return string
[154] Fix | Delete
*/
[155] Fix | Delete
private function get_request_search_query() {
[156] Fix | Delete
[157] Fix | Delete
return filter_input( INPUT_GET, 's', FILTER_SANITIZE_FULL_SPECIAL_CHARS );
[158] Fix | Delete
}
[159] Fix | Delete
[160] Fix | Delete
/**
[161] Fix | Delete
* Column title.
[162] Fix | Delete
*
[163] Fix | Delete
* @since 1.6.3
[164] Fix | Delete
*
[165] Fix | Delete
* @param Record $item List table item.
[166] Fix | Delete
*
[167] Fix | Delete
* @return string
[168] Fix | Delete
* @noinspection PhpUnused
[169] Fix | Delete
*/
[170] Fix | Delete
public function column_log_title( $item ) {
[171] Fix | Delete
[172] Fix | Delete
return sprintf(
[173] Fix | Delete
'<a href="#" class="js-single-log-target" data-log-id="%1$d"><strong>%2$s</strong></a>',
[174] Fix | Delete
absint( $item->get_id() ),
[175] Fix | Delete
esc_html( $item->get_title() )
[176] Fix | Delete
);
[177] Fix | Delete
}
[178] Fix | Delete
[179] Fix | Delete
/**
[180] Fix | Delete
* Column message.
[181] Fix | Delete
*
[182] Fix | Delete
* @since 1.6.3
[183] Fix | Delete
*
[184] Fix | Delete
* @param Record $item List table item.
[185] Fix | Delete
*
[186] Fix | Delete
* @return string
[187] Fix | Delete
* @noinspection PhpUnused
[188] Fix | Delete
*/
[189] Fix | Delete
public function column_message( $item ) {
[190] Fix | Delete
[191] Fix | Delete
$message = $item->get_message();
[192] Fix | Delete
[193] Fix | Delete
if ( preg_match( '/\[body].+{"error":"(.+)"}/i', $message, $m ) ) {
[194] Fix | Delete
$message = $m[1];
[195] Fix | Delete
}
[196] Fix | Delete
[197] Fix | Delete
if ( preg_match( '/\[error] =&gt; (.+)/i', $message, $m ) ) {
[198] Fix | Delete
$message = $m[1];
[199] Fix | Delete
}
[200] Fix | Delete
[201] Fix | Delete
return esc_html( $this->crop_message( $message ) );
[202] Fix | Delete
}
[203] Fix | Delete
[204] Fix | Delete
/**
[205] Fix | Delete
* Column form ID.
[206] Fix | Delete
*
[207] Fix | Delete
* @since 1.6.3
[208] Fix | Delete
*
[209] Fix | Delete
* @param Record $item List table item.
[210] Fix | Delete
*
[211] Fix | Delete
* @return int
[212] Fix | Delete
* @noinspection PhpUnused
[213] Fix | Delete
*/
[214] Fix | Delete
public function column_form_id( $item ) {
[215] Fix | Delete
[216] Fix | Delete
return absint( $item->get_form_id() );
[217] Fix | Delete
}
[218] Fix | Delete
[219] Fix | Delete
/**
[220] Fix | Delete
* Column types.
[221] Fix | Delete
*
[222] Fix | Delete
* @since 1.6.3
[223] Fix | Delete
*
[224] Fix | Delete
* @param Record $item List table item.
[225] Fix | Delete
*
[226] Fix | Delete
* @return string
[227] Fix | Delete
* @noinspection PhpUnused
[228] Fix | Delete
*/
[229] Fix | Delete
public function column_types( $item ) {
[230] Fix | Delete
[231] Fix | Delete
return esc_html( implode( ', ', $item->get_types( 'label' ) ) );
[232] Fix | Delete
}
[233] Fix | Delete
[234] Fix | Delete
/**
[235] Fix | Delete
* Column date.
[236] Fix | Delete
*
[237] Fix | Delete
* @since 1.6.3
[238] Fix | Delete
*
[239] Fix | Delete
* @param Record $item List table item.
[240] Fix | Delete
*
[241] Fix | Delete
* @return string
[242] Fix | Delete
* @noinspection PhpUnused
[243] Fix | Delete
*/
[244] Fix | Delete
public function column_date( $item ) {
[245] Fix | Delete
[246] Fix | Delete
return esc_html( $item->get_date( 'sql-local' ) );
[247] Fix | Delete
}
[248] Fix | Delete
[249] Fix | Delete
/**
[250] Fix | Delete
* Crop message for preview on list table.
[251] Fix | Delete
*
[252] Fix | Delete
* @since 1.6.3
[253] Fix | Delete
*
[254] Fix | Delete
* @param string $message Message.
[255] Fix | Delete
*
[256] Fix | Delete
* @return string
[257] Fix | Delete
*/
[258] Fix | Delete
private function crop_message( $message ) {
[259] Fix | Delete
[260] Fix | Delete
return wp_html_excerpt( $message, 97, '...' );
[261] Fix | Delete
}
[262] Fix | Delete
[263] Fix | Delete
/**
[264] Fix | Delete
* Prepares the _column_headers property which is used by WP_Table_List at rendering.
[265] Fix | Delete
* It merges the columns and the sortable columns.
[266] Fix | Delete
*
[267] Fix | Delete
* @since 1.6.3
[268] Fix | Delete
*/
[269] Fix | Delete
private function prepare_column_headers() {
[270] Fix | Delete
[271] Fix | Delete
$this->_column_headers = [
[272] Fix | Delete
$this->get_columns(),
[273] Fix | Delete
get_hidden_columns( $this->screen ),
[274] Fix | Delete
[],
[275] Fix | Delete
];
[276] Fix | Delete
}
[277] Fix | Delete
[278] Fix | Delete
/**
[279] Fix | Delete
* Return the columns' names for rendering.
[280] Fix | Delete
*
[281] Fix | Delete
* @since 1.6.3
[282] Fix | Delete
*
[283] Fix | Delete
* @return array
[284] Fix | Delete
*/
[285] Fix | Delete
public function get_columns() {
[286] Fix | Delete
[287] Fix | Delete
return [
[288] Fix | Delete
'log_title' => __( 'Log Title', 'wpforms-lite' ),
[289] Fix | Delete
'message' => __( 'Message', 'wpforms-lite' ),
[290] Fix | Delete
'form_id' => __( 'Form ID', 'wpforms-lite' ),
[291] Fix | Delete
'types' => __( 'Types', 'wpforms-lite' ),
[292] Fix | Delete
'date' => __( 'Date', 'wpforms-lite' ),
[293] Fix | Delete
];
[294] Fix | Delete
}
[295] Fix | Delete
[296] Fix | Delete
/**
[297] Fix | Delete
* Header before log table.
[298] Fix | Delete
*
[299] Fix | Delete
* @since 1.6.3
[300] Fix | Delete
*/
[301] Fix | Delete
private function header() {
[302] Fix | Delete
[303] Fix | Delete
?>
[304] Fix | Delete
<div class="wpforms-admin-content-header">
[305] Fix | Delete
<h4 class="wp-heading-inline"><?php esc_html_e( 'View Logs', 'wpforms-lite' ); ?>
[306] Fix | Delete
<?php if ( $this->get_request_search_query() ) { ?>
[307] Fix | Delete
<span class="subtitle">
[308] Fix | Delete
<?php
[309] Fix | Delete
printf( /* translators: %s - search query. */
[310] Fix | Delete
esc_html__( 'Search results for "%s"', 'wpforms-lite' ),
[311] Fix | Delete
esc_html( $this->get_request_search_query() )
[312] Fix | Delete
);
[313] Fix | Delete
?>
[314] Fix | Delete
</span>
[315] Fix | Delete
<?php } ?>
[316] Fix | Delete
</h4>
[317] Fix | Delete
<?php
[318] Fix | Delete
$this->hidden_fields();
[319] Fix | Delete
$this->search_box( esc_html__( 'Search Logs', 'wpforms-lite' ), 'plugin' );
[320] Fix | Delete
?>
[321] Fix | Delete
</div>
[322] Fix | Delete
<?php
[323] Fix | Delete
}
[324] Fix | Delete
[325] Fix | Delete
/**
[326] Fix | Delete
* Generate the table navigation above or below the table.
[327] Fix | Delete
*
[328] Fix | Delete
* @since 1.6.3
[329] Fix | Delete
*
[330] Fix | Delete
* @param string $which Which position.
[331] Fix | Delete
*/
[332] Fix | Delete
protected function display_tablenav( $which ) {
[333] Fix | Delete
[334] Fix | Delete
?>
[335] Fix | Delete
<div class="tablenav <?php echo esc_attr( $which ); ?>">
[336] Fix | Delete
[337] Fix | Delete
<?php
[338] Fix | Delete
if ( $which === 'top' ) {
[339] Fix | Delete
$this->extra_tablenav( $which );
[340] Fix | Delete
}
[341] Fix | Delete
$this->pagination( $which );
[342] Fix | Delete
?>
[343] Fix | Delete
[344] Fix | Delete
<br class="clear" />
[345] Fix | Delete
</div>
[346] Fix | Delete
<?php
[347] Fix | Delete
}
[348] Fix | Delete
[349] Fix | Delete
/**
[350] Fix | Delete
* Table list actions.
[351] Fix | Delete
*
[352] Fix | Delete
* @since 1.6.3
[353] Fix | Delete
*
[354] Fix | Delete
* @param string $which Position of navigation (top or bottom).
[355] Fix | Delete
*/
[356] Fix | Delete
protected function extra_tablenav( $which ) {
[357] Fix | Delete
[358] Fix | Delete
if ( ! $this->get_total() ) {
[359] Fix | Delete
return;
[360] Fix | Delete
}
[361] Fix | Delete
[362] Fix | Delete
$this->log_type_select();
[363] Fix | Delete
$this->clear_all();
[364] Fix | Delete
}
[365] Fix | Delete
[366] Fix | Delete
/**
[367] Fix | Delete
* Clear all log records.
[368] Fix | Delete
*
[369] Fix | Delete
* @since 1.6.3
[370] Fix | Delete
*/
[371] Fix | Delete
private function clear_all() {
[372] Fix | Delete
[373] Fix | Delete
?>
[374] Fix | Delete
<button name="clear-all" type="submit" class="button" value="1"><?php esc_html_e( 'Delete All Logs', 'wpforms-lite' ); ?></button>
[375] Fix | Delete
<?php
[376] Fix | Delete
}
[377] Fix | Delete
[378] Fix | Delete
/**
[379] Fix | Delete
* Update URL when table showing.
[380] Fix | Delete
* _wp_http_referer is used only on bulk actions, we remove it to keep the $_GET shorter.
[381] Fix | Delete
*
[382] Fix | Delete
* @since 1.6.3
[383] Fix | Delete
*/
[384] Fix | Delete
public function process_admin_ui() {
[385] Fix | Delete
[386] Fix | Delete
$nonce = isset( $_REQUEST['_wpnonce'] ) ? sanitize_text_field( wp_unslash( $_REQUEST['_wpnonce'] ) ) : '';
[387] Fix | Delete
[388] Fix | Delete
if ( ! wp_verify_nonce( $nonce, 'wpforms-table-' . $this->_args['plural'] ) ) {
[389] Fix | Delete
return;
[390] Fix | Delete
}
[391] Fix | Delete
[392] Fix | Delete
if ( empty( $_REQUEST['_wp_http_referer'] ) && empty( $_REQUEST['clear-all'] ) ) {
[393] Fix | Delete
return;
[394] Fix | Delete
}
[395] Fix | Delete
[396] Fix | Delete
if ( ! empty( $_REQUEST['clear-all'] ) ) {
[397] Fix | Delete
$this->repository->clear_all();
[398] Fix | Delete
}
[399] Fix | Delete
[400] Fix | Delete
$uri = isset( $_SERVER['REQUEST_URI'] ) ? esc_url_raw( wp_unslash( $_SERVER['REQUEST_URI'] ) ) : '';
[401] Fix | Delete
[402] Fix | Delete
wp_safe_redirect(
[403] Fix | Delete
remove_query_arg(
[404] Fix | Delete
[ '_wp_http_referer', '_wpnonce', 'clear-all' ],
[405] Fix | Delete
$uri
[406] Fix | Delete
)
[407] Fix | Delete
);
[408] Fix | Delete
[409] Fix | Delete
exit;
[410] Fix | Delete
}
[411] Fix | Delete
[412] Fix | Delete
/**
[413] Fix | Delete
* Message to be displayed when there are no items.
[414] Fix | Delete
*
[415] Fix | Delete
* @since 1.6.3
[416] Fix | Delete
*/
[417] Fix | Delete
public function no_items() {
[418] Fix | Delete
[419] Fix | Delete
esc_html_e( 'No logs found.', 'wpforms-lite' );
[420] Fix | Delete
}
[421] Fix | Delete
[422] Fix | Delete
/**
[423] Fix | Delete
* Print all hidden fields.
[424] Fix | Delete
*
[425] Fix | Delete
* @since 1.6.3
[426] Fix | Delete
*/
[427] Fix | Delete
private function hidden_fields() {
[428] Fix | Delete
[429] Fix | Delete
// phpcs:ignore WordPress.Security.NonceVerification.Recommended
[430] Fix | Delete
foreach ( $_GET as $key => $value ) {
[431] Fix | Delete
[432] Fix | Delete
if ( $key[0] === '_' || $key === 'paged' || $key === 'ID' ) {
[433] Fix | Delete
continue;
[434] Fix | Delete
}
[435] Fix | Delete
[436] Fix | Delete
echo '<input type="hidden" name="' . esc_attr( $key ) . '" value="' . esc_attr( $value ) . '" />';
[437] Fix | Delete
}
[438] Fix | Delete
}
[439] Fix | Delete
[440] Fix | Delete
/**
[441] Fix | Delete
* Select for choose a log type.
[442] Fix | Delete
*
[443] Fix | Delete
* @since 1.6.3
[444] Fix | Delete
*/
[445] Fix | Delete
private function log_type_select() {
[446] Fix | Delete
[447] Fix | Delete
// phpcs:ignore WordPress.Security.NonceVerification.Recommended
[448] Fix | Delete
$current_type = ! empty( $_GET['log_type'] ) ? sanitize_text_field( wp_unslash( $_GET['log_type'] ) ) : '';
[449] Fix | Delete
?>
[450] Fix | Delete
<select name="log_type">
[451] Fix | Delete
<option value=""><?php esc_html_e( 'All Logs', 'wpforms-lite' ); ?></option>
[452] Fix | Delete
<?php foreach ( Log::get_log_types() as $type_slug => $type ) { ?>
[453] Fix | Delete
<option
[454] Fix | Delete
value="<?php echo esc_attr( $type_slug ); ?>"
[455] Fix | Delete
<?php selected( $type_slug, $current_type ); ?>>
[456] Fix | Delete
<?php echo esc_html( $type ); ?>
[457] Fix | Delete
</option>
[458] Fix | Delete
<?php } ?>
[459] Fix | Delete
</select>
[460] Fix | Delete
<input type="submit" class="button" value="<?php esc_attr_e( 'Apply', 'wpforms-lite' ); ?>">
[461] Fix | Delete
<?php
[462] Fix | Delete
}
[463] Fix | Delete
[464] Fix | Delete
/**
[465] Fix | Delete
* Popup view.
[466] Fix | Delete
*
[467] Fix | Delete
* @since 1.6.3
[468] Fix | Delete
*/
[469] Fix | Delete
public function popup_template() {
[470] Fix | Delete
[471] Fix | Delete
?>
[472] Fix | Delete
<script type="text/html" id="tmpl-wpforms-log-record">
[473] Fix | Delete
<div class="wpforms-log-popup">
[474] Fix | Delete
<div class="wpforms-log-popup-block">
[475] Fix | Delete
<div class="wpforms-log-popup-label"><?php esc_html_e( 'Log Title', 'wpforms-lite' ); ?></div>
[476] Fix | Delete
<div class="wpforms-log-popup-title">{{ data.title }}</div>
[477] Fix | Delete
</div>
[478] Fix | Delete
<div class="wpforms-log-popup-block">
[479] Fix | Delete
<div class="wpforms-log-popup-label"><?php esc_html_e( 'Message', 'wpforms-lite' ); ?></div>
[480] Fix | Delete
<div class="wpforms-log-popup-message">{{{ data.message }}}</div>
[481] Fix | Delete
</div>
[482] Fix | Delete
<div class="wpforms-log-popup-flex wpforms-log-popup-flex-column-2">
[483] Fix | Delete
<div>
[484] Fix | Delete
<div class="wpforms-log-popup-label"><?php esc_html_e( 'Date', 'wpforms-lite' ); ?></div>
[485] Fix | Delete
<div class="wpforms-log-popup-create-at">{{ data.create_at }}</div>
[486] Fix | Delete
</div>
[487] Fix | Delete
<div>
[488] Fix | Delete
<div class="wpforms-log-popup-label"><?php esc_html_e( 'Types', 'wpforms-lite' ); ?></div>
[489] Fix | Delete
<div class="wpforms-log-popup-types">{{ data.types }}</div>
[490] Fix | Delete
</div>
[491] Fix | Delete
</div>
[492] Fix | Delete
<div class="wpforms-log-popup-flex wpforms-log-popup-flex-column-4">
[493] Fix | Delete
<div>
[494] Fix | Delete
<div class="wpforms-log-popup-label"><?php esc_html_e( 'Log ID', 'wpforms-lite' ); ?></div>
[495] Fix | Delete
<div class="wpforms-log-popup-id">{{ data.ID }}</div>
[496] Fix | Delete
</div>
[497] Fix | Delete
<div>
[498] Fix | Delete
<div class="wpforms-log-popup-label"><?php esc_html_e( 'Form ID', 'wpforms-lite' ); ?></div>
[499] Fix | Delete
12
It is recommended that you Edit text format, this type of Fix handles quite a lot in one request
Function