# Database
This source is based on a local or external Database Table with support for dynamic filter and order. You can create as many One to One and One to Many relations as required.
# Configuration
Before being able to use a Database table as Dynamic Content, a source instance based on it must be created first.
- Access Essentials -> Sources section in the YOOtheme Pro Customizer.
- Click on the New Source button and choose Database from the available sources.
- Optionally set a name that will be a reference for this source instance.
- Choose a table in the Table Field and leave the rest as per default.
- Click the Save button to confirm the source creation.
You can always come back and further adjust the source configuration, after the changes the source instance will be recreated.
# Database Location
The source will assume the table is part of the local system Database, you can override those defaults with a different Database or connect to an external server.
# Table Relations
Complex data structures typically involve several tables related between them, if that's the case you can set as many relations as needed of the type:
- One to One: also known as BelongsTo, relates an entry with another single entry, e.g. Article belongs to an Author.
- One to Many: also known as HasMany, relates an entry with multiple entries, e.g. Article has many Categories.
TIP
Relations can get complex and difficult to debug, an alternative simpler approach is to create a MySQL View (opens new window) with the relations solved and use that view as the main table.
# Dynamic Content
Once the source instance is created it will appear as a Dynamic Content (opens new window) option under the group Database. When selected, query settings will appear allowing to set the filter, order, and cache for the rows that are being fetched.
# Filters
The Filters allow setting static or dynamic conditions with custom evaluation logic which will be used to filter down the table rows during the fetching. Each condition is set in a panel that has access to Dynamic Content of its own, allowing to make advanced queries, for example, fetch records that belong to the current user.
# Ordering
Similarly, it is possible to order the fetched values using static and/or dynamic conditions.
# Cache
The fetched content is cached by default during 3600
seconds, if your workflow requires immediate or dynamic results disable the cache by setting it to 0
.
# Fields Mapping
Once the source is created and selected as the Dynamic Content the table fields will become available for mapping (opens new window).
# Routing
At the moment sources don't support routing, meaning that it is not possible to display a view of a single record or paginate the results.
← Getting Started CSV →