WP Data Access
  • Download
  • Support
  • Features
  • Pricing
  • Documentation
Select Page
Popular Search formimportsqlqueryexport

WP Data Access

  • Getting started
  • Installation
  • What’s new?
  • Patches
  • Known limitations
  • FAQ

Data Tables

  • Getting Started
  • Creating and publishing
  • Responsive data tables
  • SEO friendly data tables
  • Adding hyperlinks
  • Extension Manager
  • Style Manager
  • Language settings
Styling
  • Style Manager
  • Premium styling
  • Global styling
  • Code Manager Styling
  • Manual styling
  • Styling issues
Filters
  • Static filters
  • Interactive filters
    • URL parameters
    • Search Panes
    • Search Builder
    • Search form
    • Advanced search
    • Geolocation search
Export & other buttons
  • Export to PDF, CSV, Excel, SQL
  • Print & copy buttons
  • Column selection buttons
  • Custom buttons
Advanced features
  • Advanced settings
  • Large tables & performance
  • Progressively SHOW MORE
  • Custom queries
  • Custom Post Types
  • Row grouping
  • Responsive master-detail
  • Master-detail tables
  • Non admin user access
Demos & tutorials
  • Demos
  • Tutorials

Data Apps

  • Data Projects
  • Projects and templates
  • Supported Data Types
  • One-To-Many relationships
  • Many-To-Many relationships
  • Registration page
  • Manage table options
  • Shortcode usage
Project Templates
  • Project Templates
  • Creating templates
  • Table Settings
  • Relationships
  • List Table
  • Data Entry
  • Reconcile
Data Forms
  • Data Forms
  • Overview
  • Project Demo
  • Page Demo
Advanced features
  • Adding filters
  • Custom validation
  • Add less/more button
  • User roles
  • Managing roles and users
  • Advanced table options
  • Advanced lookups
  • Front-end toolbar
  • Transfer to other WP site
Demos & tutorials
  • Demos
  • Tutorials

Data Explorer

  • Getting started
  • Navigation
  • Explore tables & views
  • Manage tables & views
  • Naming conventions
Manage Actions
  • Actions
Manage Settings
  • Settings
  • Table Settings
  • Column Settings
  • Search Settings
  • Geolocation Settings
  • Dynamic Hyperlinks
  • Dashboard Menus
Data Management
  • Import CSV & SQL files
  • Run SQL script files
  • Data Backup
Problems & solutions
  • InnoDB #rows estimation
  • Import file too large
  • Transfer to other WP DB

Remote Databases

  • MySQL | MariaDB
Other DBMS
  • Heterogeneous Connections
  • Using ODBC | JDBC
  • Connect to SQL Server
Premium Data Services
  • Remote wizard
  • START HERE
  • Errors and messages
  • Limitations
  • Tutorials
  • Remote Databases
    • Remote databases
    • SQL Server
    • PostgreSQL
    • Oracle
    • MariaDB | MySQL
    Remote Data Files
    • Remote data files
    • CSV files
    • JSON files
    • MS Access
    • XML files
    • Public URL
    • Synchronization
    Advanced features
    • Performance
    • Indexes

SQL

  • Getting Started
  • Tutorials
  • Visual Query Builder
  • Writing queries
  • Data exchange
  • Stored procedures
  • Database triggers
  • Scheduled queries

Business Intelligence

  • Getting started
  • Dashboards
  • Sharing dashboards
Dashboards Widgets
  • Dashboard Widgets
  • Publication Widget
  • Project Widget
  • Chart Widget
  • Custom Code Widget
  • Database Widget
  • Sharing Widgets

Table Design

  • Getting started
  • Introduction
  • Basic mode

Plugin Settings

  • Getting started
  • Plugin
  • Back-end
  • Front-end
  • Dashboard
  • Data Forms
  • Data Tables
  • Data Backup
  • Uninstall
  • Manage Repository
  • Manage Roles
  • System Info

Code

Shortcodes
  • Overview
  • wpdataaccess
  • wpdadataproject
  • wpdadataforms
  • wpdadiehard
  • wpdageomap
  • wpdawidget
Hooks & filters
  • Overview
  • Hooks
    • Overview
    • wpda_add_search_actions
    • wpda_add_search_filter
    • wpda_before_list_table
    • wpda_after_list_table
    • wpda_wpdataaccess_prepare
    Filters
    • Overview
    • wpda_column_default
    • wpda_before_simple_form
    • wpda_after_simple_form
    • wpda_construct_where_clause
API
  • WP Data Access API
  • Remote database access
  • CRUD Example
  • Extensions
    • Alternative search algorithm
    • Alternative buttons extension
Code Manager
  • Overview
  • Write code
  • Share(d) code

Naming conventions

Table of Contents
  • Name validation
  • General rules
  • Example
  • What to do if I get a red flag?

To manage database schemas, tables and columns, the plugin often generates HTML elements, CSS classes and JavaScript variables in the back-end with their original names. Unfortunately, MySQL, HTML, CSS and jQuery all have their own limitations, which can easily lead to errors or missing features. This page describes which characters can be used in schema, table and column names without breaking plugin features or running into name based errors.

Name validation #

Name validation was introduces in version 4.2.8 to help plugin users to identify erroneous names. Name validation is performed in the back-end only (Data Explorer, Data Tables, Data Projects, and so on). A red flag is shown when a schema, table or column names does not follow the general rules as mentioned below.

NOTE For performance reasons red flags are only shown at table level. Further research might be needed to identify the erroneous name.

WP Data Access - Naming convention

General rules #

To prevent errors or missing plugin features, schema, table and column names should:

  • Start with a letter
  • Followed by any number of:
    • Letters (upper or lower case)
    • Digits 0 to 9
    • Underscores (often used to replace white spaces)
  • Be no longer than 64 characters

This works for all tools used in WP Data Access. To be safe, do not use anything else for names.

Example #

MySQL accepts white spaces in schema, tables and column names. HTML element names, CSS classes and JavaScript variables do not.

The following create table statement is allowed in MySQL:

create table my demo
(my id int not null auto_increment primary key
,my text text
);

The plugin however, will not be able to support all features with white spaces in the table and column name.

The following create table statement solves this issue:

create table my_demo
(my_id int not null auto_increment primary key
,my_text text
);

All plugin features are supported with these table and column names.

What to do if I get a red flag? #

  • Check your schema, table, and column names
  • Find the name(s) that do not follow the general rules
  • Change the name

You might need to take additional actions for schema, table, and column names that are already used in data tables or projects. Please use the forum if you need help.

Share This Article :
  • Facebook
  • Twitter
  • LinkedIn
  • Pinterest
Still stuck? How can we help?

How can we help?

Updated on 2023-01-13
Manage tables & views

2 Comments

  1. Roger Trouillard
    Roger Trouillard on 2021-06-02 at 5:43 pm

    After upgrade to this new feature, all objects are flagged ! Even if table names and field names respect the rule.
    … But the database name is as following : “123456_DatabaseName”, where “123456” is imposed by the website host !
    No possibility for me to change the begin of the name of the database “123456…” !!!

    Reply
    • Peter Schulz
      Peter Schulz on 2021-06-03 at 1:06 pm

      Hi Roger,

      Good point! ISP hosted databases may start with a number. And there is nothing you can do about it.

      The plugin performs a couple of checks. It looks like the numeric check on the first character is only needed for HTML4. It’s not necessary for HTML5.

      Can I presume WordPress generates HTML5 at all times? Anybody???

      BTW, this is just a message! What worked will continue to work. Let me know if you have any issues.

      Thanks,
      Peter

      Reply

Submit a Comment Cancel reply

Your email address will not be published. Required fields are marked *

Table of Contents
  • Name validation
  • General rules
  • Example
  • What to do if I get a red flag?

Links

Blogs
Tutorials
Demos

Socials

LinkedIn
Twitter

Get in touch

Premium support
Free support forum
Contact us

Resources

WordPress plugin directory
YouTube tutorials

Passionate Programmers B.V. © 2017 - 2023 All rights reserved
We use cookies to ensure that we give you the best experience on our website. If you continue to use this site we will assume that you are happy with it.Ok