Modifier: :maxwords
Limit to N words. Write it after a colon: {Notes:5:maxwords:10}
About
Trims the value to N words and appends an ellipsis. Unbalanced HTML is repaired afterwards.
| Product | GravityView |
|---|---|
| Requires | GravityView 1.17 or later |
| Works on | form fields |
| In the picker | Change the output |
How to use it
Show a short excerpt
Cuts the value after the given number of words and adds an ellipsis.
Write
<p>{Notes:2:maxwords:5}</p>Get
<p>it's -- <b>QUICK</b>, brown Fox…</p>Examples
Rendered by real Gravity Forms and GravityKit PHP against a test entry.
| Merge tag | Output | Without the modifier |
|---|---|---|
{Notes:2:maxwords:3} | it's -- <b>QUICK</b>,… | it's -- <b>QUICK</b>, brown Fox jumps over the lazy dog and it wasn't <b>that</b> slow & steady.<br /> <br /> Ada Lovelace wrote the first algorithm. |
Where the merge tag picker offers it
Form fields: Single line text · Paragraph text · Email · Website · Hidden · Consent · Signature · Drop down · Radio buttons · Checkboxes, one choice · Multi select · Image choice · Multiple choice · Post category · Calculation · Product · Product (single) · Product (hidden) · Product price · Option · Shipping · Shipping (single) · Date, after a custom format · Time · Name, one part · Address, one part · Phone, standard format · File upload · Post image · List · Repeater.
Where it is left out
| Field kinds | Why |
|---|---|
| Checkboxes · Name · Address | Skipped on the whole field. The field is stored as several values, and GravityView skips it. Write one input instead, like .3 for a first name. |
| Number · Quantity · Total | Changes nothing on this field. A number has no letters and is one word, so case changes, word limits and escaping leave it as it is. |
| Date | Needs a date format first. GravityView changes the stored date (2024-03-09), which has no letters. Add “Custom date format” or “Human-readable time difference” first. |
| Phone, international format | Works on the stored record. An international phone field stores a record like {"country":"US",…}. GravityView would change that record, not the number people see. |