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

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
  • Plugin Variables
    • WordPress user ID in SQL
    • Environment variables
  • 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

Adding filters

There are three ways to add a filter to a Data Project

  1. Default where clause
  2. Shortcode parameters
  3. URL parameters

Default where clause #

The Data Projects tools allow plugin users to add any default where clause to a project page (click image below to enlarge). This includes subqueries and other more complex filters. The default where clause also supports the $$USER$$, $$USERID$$ and $$EMAIL$$ environment variables to filter user-specific data (user must be logged in).
WP Data Access - Data Projects - Default where

Shortcode parameters #

Shortcode parameters are available for shortcode wpdadiehard only. These parameters are not available for shortcodes wpdadataproject and wpdadataforms.

Shortcode wpdadiehard provides the following two parameters to filter data:

  • filter_field_name (field name(s) to be filtered)
  • filter_field_value (field value(s) to filter, performs a LIKE and therefor allows wildcards)

Example of a filter for one specific column:

[wpdadiehard project_id="8" page_id="43" filter_field_name="lastname" filter_field_value="jose%25"]

For filters containing multiple column names and values, use a comma-separated value and make sure the array size of filter_field_name and filter_field_value are the same.

For example:

[wpdadiehard project_id="6" page_id="31" filter_field_name="job,ename" filter_field_value="president,ford"]

The filter allows to use % as a wildcard as shown in the single column filter example. These filter parameters do not support operators like IN, OR, NOT, >, < and so on. Please use the default where clause to use these operators and more complex filters.

URL parameters #

To add a filter on a specific table column you can add an URL argument to your request that follows the following name convention:

wpda_search_column_<column_name>

Example (GET and POST)

YOUR-URL/?wpda_search_column_first_name=Sacha
<input name="wpda_search_column_first_name" type="text" value="Sacha" />

Adds condition

first_name = 'Sacha'

Wilcards are supported in URL parameters as well

YOUR-URL/?wpda_search_column_title=Last%25

IN conditions #

Use arrays to filter a column on multiple values (allows wildcard usage as well). For example:

YOUR-URL/?wpda_search_column_first_name[0]=Sacha&wpda_search_column_first_name[1]=Peter

Adds condition

first_name in ('Sacha', 'Peter')

OR conditions #

Use parameter wpda_search_column_operator to compare using OR instead of AND. The plugin uses AND by default.

Example AND (default) #

YOUR-URL/?wpda_search_column_first_name=Sacha&wpda_search_column_last_name=Schulz

Adds condition

first_name = 'Sacha' AND last_name = 'Peter'

Example OR #

YOUR-URL/?wpda_search_column_first_name=Sacha&wpda_search_column_last_name=Schulz&wpda_search_column_operator=or

Adds condition

first_name = 'Sacha' OR last_name = 'Peter'

It is currently not possible to combine AND and OR conditions with URL parameters.

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

How can we help?

Updated on 2023-03-31
Custom validation

Submit a Comment Cancel reply

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

Table of Contents
  • Default where clause
  • Shortcode parameters
  • URL parameters
    • IN conditions
    • OR conditions
      • Example AND (default)
      • Example OR

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

IMPORTANT message for free users with version 5.3.9 installed

WP Data Access version 5.3.9 is not seeing new updates in the plugin page. The latest version is currently 5.3.15.

To download the latest update, please follow these steps:

    • Deactivate and delete version 5.3.9. This will NOT delete your data, but if you’re worried, you can also simply deactivate version 5.3.9, and then rename the plugin folder temporarily via FTP.
    • Download the lastest version of WP Data Access from the WordPress plugin directory (click the Download button)
    • Login to your WordPress dashboard
    • Navigate to Plugins > Add New > Upload Plugin
    • Select the zip file for 5.3.15, and then click Install Now.
    • Activate the new version (and delete the old version 5.3.9).

 

Feel free to message us if you encounter any problems during the update.