# wp-data-access/5.5.80/WPDataAccess/Data_Dictionary/WPDA_Dictionary_Lists.php

WP Data Access – App Builder for Tables, Forms, Charts, Maps & Dashboards, version 5.5.80. 436 lines.

- Page: https://pluginprobe.com/plugins/wp-data-access/5.5.80/code/WPDataAccess/Data_Dictionary/WPDA_Dictionary_Lists.php
- Raw: https://pluginprobe.com/plugins/wp-data-access/5.5.80/raw/WPDataAccess/Data_Dictionary/WPDA_Dictionary_Lists.php
- Modified: 2026-08-06T09:12:38+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/wp-data-access/5.5.80/code/WPDataAccess/Data_Dictionary/WPDA_Dictionary_Lists.php#L10-L20`.

```php
<?php

/**
 * Suppress "error - 0 - No summary was found for this file" on phpdoc generation
 *
 * @package WPDataAccess\Data_Dictionary
 */

namespace WPDataAccess\Data_Dictionary {

	use WPDataAccess\Connection\WPDADB;
	use WPDataAccess\WPDA;

	/**
	 * Class WPDA_Dictionary_Lists
	 *
	 * @author  Peter Schulz
	 * @since   1.0.0
	 */
	class WPDA_Dictionary_Lists {

		/**
		 * List of tables for setting pages
		 *
		 * Returns an array including all tables and views in the WordPress database.
		 *
		 * Do NOT use table access control here! This list is used in the settings forms and must show ALL tables in
		 * the WordPress database.
		 *
		 * @param string  $schema_name Database schema name
		 * @param boolean $show_views TRUE = show views, FALSE = hide views.
		 *
		 * @return array List of database tables (and views).
		 * @since   1.0.0
		 */
		public static function get_tables( $show_views = true, $schema_name = '' ) {
			$wpdadb = WPDADB::get_db_connection( $schema_name );
			if ( $wpdadb === null ) {
				return array();
			}

			if ( false === $show_views ) {
				$and = " and table_type != 'VIEW' ";
			} else {
				$and = '';
			}

			$query = $wpdadb->prepare(
				"
				select table_name AS table_name,
					   create_time AS create_time,
					   table_rows AS table_rows
				  from information_schema.tables
				 where table_schema = %s
				 $and
				 order by table_name
				",
				array(
					$wpdadb->dbname,
				)
			);

			return $wpdadb->get_results( $query, 'ARRAY_A' ); 
		}

		public static function get_table_row_count_ajax() {
			if (
				isset( $_POST['wpda_wpnonce'] ) &&
				isset( $_POST['wpdaschema_name'] ) &&
				isset( $_POST['wpdatable_name'] )
			) {
				$wpnonce     = sanitize_text_field( wp_unslash( $_REQUEST['wpda_wpnonce'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotValidated
				$schema_name = sanitize_text_field( wp_unslash( $_REQUEST['wpdaschema_name'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotValidated
				$table_name  = sanitize_text_field( wp_unslash( $_REQUEST['wpdatable_name'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotValidated

				if ( ! wp_verify_nonce( $wpnonce, "wpda-get-row-count-{$table_name}" ) ) {
					echo json_encode( array() );
				} else {
					$wpdadb = WPDADB::get_db_connection( $schema_name );

					if ( $wpdadb === null ) {
						echo json_encode( array() );
					} else {
						$query = 'select count(*) as row_count from `' . str_replace( '`', '', $table_name ) . '`';
						echo json_encode( $wpdadb->get_results( $query, 'ARRAY_A' ) ); 
					}
				}
			} else {
				echo json_encode( array() );
			}
		}

		/**
		 * List all tables in a specific schema
		 *
		 * jQuery usage: action=wpda_get_tables
		 *
		 * @return array
		 */
		public static function get_tables_ajax() {
			if ( isset( $_REQUEST['wpdaschema_name'] ) && isset( $_REQUEST['wpda_wpnonce'] ) ) {
				$wpnonce = sanitize_text_field( wp_unslash( $_REQUEST['wpda_wpnonce'] ) ); // input var okay.
				if ( ! wp_verify_nonce( $wpnonce, 'wpda-getdata-access-' . WPDA::get_current_user_login() ) ) {
					echo json_encode( array() );
				} else {
					$schema_name = sanitize_text_field( wp_unslash( $_REQUEST['wpdaschema_name'] ) ); // input var okay.
					$wpdadb      = WPDADB::get_db_connection( $schema_name );

					if ( $wpdadb === null ) {
						echo json_encode( array() );
					} else {
						global $wpdb;
						if ( $wpdb->dbname === $schema_name ) {
							$table_access = WPDA::get_option( WPDA::OPTION_BE_TABLE_ACCESS );
						} else {
							$table_access = get_option( WPDA::BACKEND_OPTIONNAME_DATABASE_ACCESS . $schema_name );
							if ( false === $table_access ) {
								$table_access = 'show';
							}
						}

						$and = '';
						if ( 'hide' === $table_access ) {
							$wp_tables = $wpdb->tables( 'all', true );
							$and       = " and `table_name` not in ('" . implode( "','", $wp_tables ) . "') ";
						} else if ( 'show' !== $table_access ) {
							// Show only selected tables and views
							if ( $wpdb->dbname === $schema_name ) {
								$tables = WPDA::get_option( WPDA::OPTION_BE_TABLE_ACCESS_SELECTED );
							} else {
								$tables = get_option( WPDA::BACKEND_OPTIONNAME_DATABASE_SELECTED . $schema_name );
								if ( false === $tables ) {
									$tables = array();
								}
							}
							if ( count( $tables ) > 0 ) { // phpcs:ignore -- 8.1 proof
								$and = " and `table_name` in ('" . implode( "','", $tables ) . "') ";
							}
						}

						$hide_views = isset( $_REQUEST['hideviews'] ) && 'TRUE' === $_REQUEST['hideviews'];
						if ( $hide_views ) {
							$and .= " and `table_type` != 'VIEW' ";
						}

						$query = $wpdadb->prepare(
							"
							select `table_name` AS table_name
							  from `information_schema`.`tables`
							 where `table_schema` = %s
							 $and
							 order by `table_name`
							",
							array(
								$wpdadb->dbname,
							)
						);

						echo json_encode( $wpdadb->get_results( $query, 'ARRAY_A' ) ); 
					}
				}
			} else {
				echo json_encode( array() );
			}
		}

		/**
		 * List of columns for a specific table
		 *
		 * jQuery usage: action=wpda_get_columns
		 *
		 * @return array List of column for a specific table.
		 * @since   1.6.10
		 */
		public static function get_columns() {
			if ( isset( $_REQUEST['wpdaschema_name'] ) && isset( $_REQUEST['table_name'] ) && isset( $_REQUEST['wpda_wpnonce'] ) ) {
				$wpnonce = sanitize_text_field( wp_unslash( $_REQUEST['wpda_wpnonce'] ) ); // input var okay.
				if ( ! wp_verify_nonce( $wpnonce, 'wpda-getdata-access-' . WPDA::get_current_user_login() ) ) {
					echo json_encode( array() );
				} else {
					$schema_name = isset( $_REQUEST['wpdaschema_name'] ) ? sanitize_text_field( wp_unslash( $_REQUEST['wpdaschema_name'] ) ) : ''; // input var okay.
					$table_name  = sanitize_text_field( wp_unslash( $_REQUEST['table_name'] ) ); // input var okay.
					$wpdadb      = WPDADB::get_db_connection( $schema_name );

					if ( $wpdadb === null ) {
						echo json_encode( array() );
					} else {
						$query = $wpdadb->prepare(
							'
							  SELECT column_name AS column_name
								FROM information_schema.columns
							   WHERE table_schema = %s
								 AND table_name   = %s
							   ORDER BY ordinal_position
							',
							array(
								$wpdadb->dbname,
								$table_name,
							)
						);

						echo json_encode( $wpdadb->get_results( $query, 'ARRAY_A' ) ); 
					}
				}
			} else {
				echo json_encode( array() );
			}
		}

        public static function get_table_widget_info_ajax() {
            $table_info = array();

            if ( isset( $_POST['wpdaschema_name'] ) && isset( $_POST['table_name'] ) && isset( $_POST['wpda_wpnonce'] ) ) {
                $wpnonce = sanitize_text_field(wp_unslash($_POST['wpda_wpnonce'])); // input var okay.
                if (wp_verify_nonce($wpnonce, 'wpda-getdata-access-' . WPDA::get_current_user_login())) {
                    $schema_name = isset($_POST['wpdaschema_name']) ? sanitize_text_field(wp_unslash($_POST['wpdaschema_name'])) : ''; // input var okay.
                    $table_name = sanitize_text_field(wp_unslash($_POST['table_name'])); // input var okay.
                    $table_info = self::get_table_widget_info( $schema_name, $table_name );
                }
            }

            echo json_encode( $table_info );
        }

		public static function get_table_widget_info( $schema_name, $table_name ) {
            $wpdadb = WPDADB::get_db_connection( $schema_name );

            if ( $wpdadb !== null ) {
                $query = $wpdadb->prepare(
                    '
                      SELECT column_name AS column_name,
                             column_type AS column_type
                        FROM information_schema.columns
                       WHERE table_schema = %s
                         AND table_name   = %s
                       ORDER BY ordinal_position
                    ',
                    array(
                        $wpdadb->dbname,
                        $table_name,
                    )
                );
                $columns = $wpdadb->get_results($query, 'ARRAY_A');

                $schema_name = $wpdadb->dbname;
                $table_name = str_replace('`', '', $table_name);
                $indexes_dbs = $wpdadb->get_results(
                    "show indexes from `{$schema_name}`.`{$table_name}`",
                    'ARRAY_A'
                );

                $indexes = array();
                foreach ($indexes_dbs as $index_dbs) {
                    $indexes[] = array_change_key_case((array)$index_dbs);  // phpcs:ignore -- 8.1 proof
                }

                return array(
                    'columns' => $columns,
                    'indexes' => $indexes,
                );
            }
		}

		/**
		 * List of columns for a specific table
		 *
		 * @param string $table_name Database table name
		 * @param string $schema_name Database schema name
		 *
		 * @return Column in $table_name
		 * @since   2.0.10
		 */
		public static function get_table_columns( $table_name, $schema_name ) {
			$wpdadb = WPDADB::get_db_connection( $schema_name );
			if ( $wpdadb === null ) {
				return array();
			} else {
				$query = $wpdadb->prepare(
					'
				  SELECT column_name AS column_name
					FROM information_schema.columns
				   WHERE table_schema = %s
					 AND table_name   = %s
				   ORDER BY ordinal_position
				',
					array(
						$wpdadb->dbname,
						$table_name,
					)
				);

				return $wpdadb->get_results( $query, 'ARRAY_A' ); 
			}
		}

		/**
		 * List of database schemas available to user
		 *
		 * @param bool $incl_remote_dbs Include remote database connections? (for backward compatibility)
		 *
		 * @return array
		 *
		 * @since   1.6.0
		 */
		public static function get_db_schemas( $incl_remote_dbs = true ) {
			global $wpdb;
			$schemas = $wpdb->get_results( // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
				'SELECT schema_name AS schema_name
				   FROM information_schema.schemata
				  ORDER BY schema_name',
				'ARRAY_A'
			);

			$remote = array();
			if ( $incl_remote_dbs ) {
				$rdb = WPDADB::get_remote_databases();
				foreach ( $rdb as $key => $val ) {
					$remote[] = array(
						'schema_name' => $key,
					);
				}
				asort( $remote ); // phpcs:ignore -- 8.1 proof
			}

			return array_merge( $schemas, $remote ); // phpcs:ignore -- 8.1 proof
		}

		/**
		 * List of available engines
		 *
		 * @param string $schema_name Database schema name (default = WordPress schema)
		 *
		 * @return array
		 *
		 * @since   1.6.0
		 */
		public static function get_engines( $schema_name = '' ) {
			$wpdadb = WPDADB::get_db_connection( $schema_name );
			if ( $wpdadb === null ) {
				return array();
			} else {
				return $wpdadb->get_results(
					'SELECT engine AS engine,
							support AS support
					   FROM information_schema.engines
					 ORDER BY engine',
					'ARRAY_A'
				);
			}
		}

		/**
		 * List of available collations
		 *
		 * @param string $schema_name Database schema name (default = WordPress schema)
		 *
		 * @return array
		 *
		 * @since   1.6.0
		 */
		public static function get_collations( $schema_name = '' ) {
			$wpdadb = WPDADB::get_db_connection( $schema_name );
			if ( $wpdadb === null ) {
				return array();
			} else {
				return $wpdadb->get_results(
					'SELECT character_set_name AS character_set_name,
							collation_name AS collation_name
					 FROM   information_schema.collations
					 ORDER BY character_set_name, collation_name',
					'ARRAY_A'
				);
			}
		}

		/**
		 * Returns default collation
		 *
		 * @param string $schema_name Database schema name (default = WordPress schema)
		 *
		 * @return array
		 *
		 * @since   1.6.0
		 */
		public static function get_default_collation( $schema_name = '' ) {
			$wpdadb = WPDADB::get_db_connection( $schema_name );
			if ( $wpdadb === null ) {
				return array();
			} else {
				return $wpdadb->get_results(
					$wpdadb->prepare(
						'SELECT default_character_set_name AS default_character_set_name,
								default_collation_name AS default_collation_name
						 FROM   information_schema.schemata
						 WHERE  schema_name = %s
						 GROUP BY schema_name',
						array(
							$wpdadb->dbname,
						)
					),
					'ARRAY_A'
				);
			}
		}

		public static function get_engine( $schema_name, $table_name ) {
			$wpdadb = WPDADB::get_db_connection( $schema_name );
			if ( $wpdadb === null ) {
				return null;
			} else {
				$row = $wpdadb->get_results(
					$wpdadb->prepare(
						'SELECT engine AS engine
						   FROM information_schema.tables
						  WHERE table_schema = %s
							AND table_name = %s
					    ',
						array(
							$wpdadb->dbname,
							$table_name,
						)
					),
					'ARRAY_A'
				);
				if ( 1 === count( $row ) ) { // phpcs:ignore -- 8.1 proof
					return $row[0]['engine'];
				} else {
					return null;
				}
			}
		}

	}

}

```