1
|
|
|
<?php |
|
|
|
|
2
|
|
|
namespace GV; |
3
|
|
|
|
4
|
|
|
/** If this file is called directly, abort. */ |
5
|
|
|
if ( ! defined( 'GRAVITYVIEW_DIR' ) ) { |
6
|
|
|
die(); |
7
|
|
|
} |
8
|
|
|
|
9
|
|
|
/** |
10
|
|
|
* The Entry Table Template class . |
11
|
|
|
* |
12
|
|
|
* Renders a \GV\Entry using a \GV\Entry_Renderer. |
13
|
|
|
*/ |
14
|
|
|
class Entry_Table_Template extends Entry_Template { |
15
|
|
|
/** |
16
|
|
|
* @var string The template slug to be loaded (like "table", "list") |
17
|
|
|
*/ |
18
|
|
|
public static $slug = 'table'; |
19
|
|
|
|
20
|
|
|
/** |
21
|
|
|
* Output a field cell. |
22
|
|
|
* |
23
|
|
|
* @param \GV\Field $field The field to be ouput. |
24
|
|
|
* |
25
|
|
|
* @return string|false The field output or false if "hide_empty" is set. |
26
|
|
|
*/ |
27
|
10 |
|
public function the_field( \GV\Field $field ) { |
28
|
10 |
|
$renderer = new Field_Renderer(); |
29
|
10 |
|
$source = is_numeric( $field->ID ) ? ( GF_Form::by_id( $field->form_id ) ? : $this->view->form ) : new Internal_Source(); |
|
|
|
|
30
|
|
|
|
31
|
10 |
|
return $renderer->render( $field, $this->view, $source, $this->entry->from_field( $field ), $this->request ); |
32
|
|
|
} |
33
|
|
|
|
34
|
|
|
/** |
35
|
|
|
* Out the single entry table body. |
36
|
|
|
* |
37
|
|
|
* @return void |
38
|
|
|
*/ |
39
|
10 |
|
public function the_entry() { |
40
|
|
|
|
41
|
|
|
/** @var \GV\Field_Collection $fields */ |
42
|
10 |
|
$fields = $this->view->fields->by_position( 'single_table-columns' )->by_visible(); |
43
|
|
|
|
44
|
10 |
|
$context = Template_Context::from_template( $this, compact( 'fields' ) ); |
45
|
|
|
|
46
|
|
|
/** |
47
|
|
|
* @filter `gravityview_table_cells` Modify the fields displayed in a table |
48
|
|
|
* @param array $fields |
49
|
|
|
* @param \GravityView_View $this |
50
|
|
|
* @deprecated Use `gravityview/template/table/fields` |
51
|
|
|
*/ |
52
|
10 |
|
$fields = apply_filters( 'gravityview_table_cells', $fields->as_configuration(), \GravityView_View::getInstance() ); |
53
|
10 |
|
$fields = Field_Collection::from_configuration( $fields ); |
54
|
|
|
|
55
|
|
|
/** |
56
|
|
|
* @filter `gravityview/template/table/fields` Modify the fields displayed in this tables. |
57
|
|
|
* @param \GV\Field_Collection $fields The fields. |
58
|
|
|
* @param \GV\Template_Context $context The context. |
59
|
|
|
* @since 2.0 |
60
|
|
|
*/ |
61
|
10 |
|
$fields = apply_filters( 'gravityview/template/table/fields', $fields, $context ); |
62
|
|
|
|
63
|
10 |
|
foreach ( $fields->all() as $field ) { |
64
|
10 |
|
$context = Template_Context::from_template( $this, compact( 'field' ) ); |
65
|
|
|
|
66
|
10 |
|
$form = \GV\GF_Form::by_id( $field->form_id ) ? : $this->view->form; |
67
|
10 |
|
$entry = $this->entry->from_field( $field ); |
|
|
|
|
68
|
|
|
|
69
|
10 |
|
if ( ! $entry ) { |
70
|
|
|
continue; |
71
|
|
|
} |
72
|
|
|
|
73
|
|
|
/** |
74
|
|
|
* @deprecated Here for back-compatibility. |
75
|
|
|
*/ |
76
|
10 |
|
$column_label = apply_filters( 'gravityview_render_after_label', $field->get_label( $this->view, $form, $entry ), $field->as_configuration() ); |
77
|
10 |
|
$column_label = apply_filters( 'gravityview/template/field_label', $column_label, $field->as_configuration(), $form->form ? $form->form : null, $entry->as_entry() ); |
|
|
|
|
78
|
|
|
|
79
|
|
|
/** |
80
|
|
|
* @filter `gravityview/template/field/label` Override the field label. |
81
|
|
|
* @since 2.0 |
82
|
|
|
* @param[in,out] string $column_label The label to override. |
83
|
|
|
* @param \GV\Template_Context $context The context. |
84
|
|
|
*/ |
85
|
10 |
|
$column_label = apply_filters( 'gravityview/template/field/label', $column_label, $context ); |
86
|
|
|
|
87
|
|
|
/** |
88
|
|
|
* @filter `gravityview/template/table/entry/hide_empty` |
89
|
|
|
* @param boolean $hide_empty Should the row be hidden if the value is empty? Default: don't hide. |
90
|
|
|
* @param \GV\Template_Context $context The context ;) Love it, cherish it. And don't you dare modify it! |
91
|
|
|
*/ |
92
|
10 |
|
$hide_empty = apply_filters( 'gravityview/render/hide-empty-zone', $this->view->settings->get( 'hide_empty', false ), $context ); |
93
|
|
|
|
94
|
10 |
|
echo \gravityview_field_output( array( |
|
|
|
|
95
|
10 |
|
'entry' => $this->entry->as_entry(), |
96
|
10 |
|
'field' => is_numeric( $field->ID ) ? $field->as_configuration() : null, |
97
|
10 |
|
'label' => $column_label, |
98
|
10 |
|
'value' => $this->the_field( $field ), |
99
|
10 |
|
'markup' => '<tr id="{{ field_id }}" class="{{ class }}"><th scope="row">{{ label }}</th><td>{{ value }}</td></tr>', |
100
|
10 |
|
'hide_empty' => $hide_empty, |
101
|
10 |
|
'zone_id' => 'single_table-columns', |
102
|
10 |
|
), $context ); |
103
|
|
|
} |
104
|
10 |
|
} |
105
|
|
|
} |
106
|
|
|
|
The PSR-1: Basic Coding Standard recommends that a file should either introduce new symbols, that is classes, functions, constants or similar, or have side effects. Side effects are anything that executes logic, like for example printing output, changing ini settings or writing to a file.
The idea behind this recommendation is that merely auto-loading a class should not change the state of an application. It also promotes a cleaner style of programming and makes your code less prone to errors, because the logic is not spread out all over the place.
To learn more about the PSR-1, please see the PHP-FIG site on the PSR-1.