mbr_progress_tags
Usage
This shortcode returns a progress factor either as; a percentage of the total, fraction of the total, a rounded division, or simple counter. The progress factor is calculated from the number of tags assigned to the contact linked to the logged in user compared to a specified list of available tags.
Parameters
| Parameters | Description |
|---|---|
| tags | One or more ActiveCampaign tag ID's, separated using commas, to be the basis for the comparison against the logged in users assigned tags. The available tags can be found in ActiveMember360, Utilities, Tags. Default: none. Required: yes. |
| format | The format for the result. Permitted Values: p for percentage (e.g. 83%), f for fraction (e.g. 5/7), n for rounded numeric (e.g. 4.2), c for simple counter (e.g. 5) Default: p Required: no. |
| round | The decimal rounding to apply to the result. Only applies when format paramaeter is set for percentage or rounded numeric.Default: 0 Required: no. |
| callbacks | A comma separated list of callback functions to be called to further process the return value of the shortcode. Default: none. Required: no. |
Validity
This shortcode is only evaluated for logged in users who also exist as contacts within ActiveCampaign.
In all other cases, including WordPress users with the Administrator role a progress factor with a value of zero will be returned.
Conditional Branching
This shortcode does NOT support conditional branching with [ELSE_progress_tags].
Nesting
Shortcode nesting is NOT supported.
Examples
- Example 1
- Example 2
- Example 3
- Example 4
- Example 5
Generates a percentage value determined by the number of tags the ActiveCampaign contact linked to the logged in user has assigned from the list of tag IDs 123, 456, 789 rounded to zero decimal places. For example if the user has one of those tags the value is 33.
[mbr_progress_tags format='p' tags='123,456,789']
Generates a percentage value determined by the number of tags the ActiveCampaign contact linked to the logged in user has assigned from the list of tag IDs 123, 456, 789 rounded to two decimal places. For example if the user has one of those tags the value is 33.33.
[mbr_progress_tags format='p' round='2' tags='123,456,789']
Generates a rounded numeric value determined by the number of tags the ActiveCampaign contact linked to the logged in user has assigned from the list of tag IDs 123, 456, 789 rounded to two decimal places. For example if the user has one of those tags the value is 0.33.
[mbr_progress_tags format='n' round='2' tags='123,456,789']
Generates a fraction value determined by the number of tags the ActiveCampaign contact linked to the logged in user has assigned from the list of tag IDs 123, 456, 789 rounded to two decimal places. For example if the user has one of those tags the value is 1/3.
[mbr_progress_tags format='f' tags='123,456,789']
Generates a count value determined by the number of tags the ActiveCampaign contact linked to the logged in user has assigned from the list of tag IDs 123, 456, 789 rounded to two decimal places. For example if the user has one of those tags the value is 1.
[mbr_progress_tags format='c' tags='123,456,789']
API
There is currently no ActiveMember360 API function equivalent for this shortcode.