export_formats = array(
'csv' => __( 'CSV - Character-Separated Values', 'tablepress' ),
'html' => __( 'HTML - Hypertext Markup Language', 'tablepress' ),
'json' => __( 'JSON - JavaScript Object Notation', 'tablepress' ),
);
$this->csv_delimiters = array(
';' => __( '; (semicolon)', 'tablepress' ),
',' => __( ', (comma)', 'tablepress' ),
'tab' => __( '\t (tabulator)', 'tablepress' ),
);
/** This filter is documented in the WordPress function unzip_file() in wp-admin/includes/file.php */
if ( class_exists( 'ZipArchive' ) && apply_filters( 'unzip_file_use_ziparchive', true ) ) {
$this->zip_support_available = true;
}
}
/**
* Export a table.
*
* @since 1.0.0
*
* @param array $table Table to be exported.
* @param string $export_format Format for the export ('csv', 'html', 'json').
* @param string $csv_delimiter Delimiter for CSV export.
* @return string Exported table (only data for CSV and HTML, full tables (including options) for JSON).
*/
public function export_table( array $table, $export_format, $csv_delimiter ) {
switch ( $export_format ) {
case 'csv':
$output = '';
if ( 'tab' === $csv_delimiter ) {
$csv_delimiter = "\t";
}
foreach ( $table['data'] as $row_idx => $row ) {
$csv_row = array();
foreach ( $row as $column_idx => $cell_content ) {
$csv_row[] = $this->csv_wrap_and_escape( $cell_content, $csv_delimiter );
}
$output .= implode( $csv_delimiter, $csv_row );
$output .= "\n";
}
break;
case 'html':
$num_rows = count( $table['data'] );
$last_row_idx = $num_rows - 1;
$thead = '';
$tfoot = '';
$tbody = array();
foreach ( $table['data'] as $row_idx => $row ) {
// First row, need to check for head (but only if at least two rows).
if ( 0 === $row_idx && $table['options']['table_head'] && $num_rows > 1 ) {
$thead = $this->html_render_row( $row, 'th' );
continue;
}
// Last row, need to check for footer (but only if at least two rows).
if ( $last_row_idx === $row_idx && $table['options']['table_foot'] && $num_rows > 1 ) {
$tfoot = $this->html_render_row( $row, 'th' );
continue;
}
// Neither first nor last row (with respective head/foot enabled), so render as body row.
$tbody[] = $this->html_render_row( $row, 'td' );
}
// , , and tags.
if ( ! empty( $thead ) ) {
$thead = "\t\n{$thead}\t\n";
}
if ( ! empty( $tfoot ) ) {
$tfoot = "\t\n{$tfoot}\t\n";
}
$tbody = "\t\n" . implode( '', $tbody ) . "\t\n";
$output = "\n" . $thead . $tfoot . $tbody . "
\n";
break;
case 'json':
$output = json_encode( $table );
break;
default:
$output = '';
}
return $output;
}
/**
* Wrap and escape a cell for CSV export.
*
* @since 1.0.0
*
* @param string $string Content of a cell.
* @param string $delimiter CSV delimiter character.
* @return string Wrapped string for CSV export
*/
protected function csv_wrap_and_escape( $string, $delimiter ) {
// Escape CSV delimiter for RegExp (e.g. '|').
$delimiter = preg_quote( $delimiter, '#' );
if ( 1 === preg_match( '#' . $delimiter . '|"|\n|\r#i', $string ) || ' ' === substr( $string, 0, 1 ) || ' ' === substr( $string, -1 ) ) {
// Escape single " as double "".
$string = str_replace( '"', '""', $string );
// Wrap string in "".
$string = '"' . $string . '"';
}
return $string;
}
/**
* Generate the HTML of a row.
*
* @since 1.0.0
*
* @param array $row Cells of the row to be rendered.
* @param string $tag HTML tag to use for the cells (td or th).
* @return string HTML code for the row.
*/
protected function html_render_row( array $row, $tag ) {
$output = "\t\t\n";
array_walk( $row, array( $this, 'html_wrap_and_escape' ), $tag );
$output .= implode( '', $row );
$output .= "\t\t
\n";
return $output;
}
/**
* Wrap and escape a cell for HTML export.
*
* @since 1.0.0
*
* @param string $cell_content Content of a cell.
* @param int|null $column_idx Column index, or null if omitted. Unused, but defined to be able to use function as callback in array_walk().
* @param string $html_tag HTML tag that shall be used for the cell.
*/
protected function html_wrap_and_escape( &$cell_content, $column_idx, $html_tag ) {
/*
* Replace any & with & that is not already an encoded entity (from function htmlentities2 in WP 2.8).
* A complete htmlentities2() or htmlspecialchars() would encode tags, which we don't want.
*/
$cell_content = preg_replace( '/&(?![A-Za-z]{0,4}\w{2,3};|#[0-9]{2,4};)/', '&', $cell_content );
$cell_content = "\t\t\t<{$html_tag}>{$cell_content}\n";
}
} // class TablePress_Export