Macros

Macros are special constructions which can be inserted in some text input (such as blog post or wiki). This construction is converted dynamically upon output. For example it's possible to insert join page into wiki page, or insert search results by some keyword into html block, it insert photo snippet into blog post.

Constructions have the following syntax Error: malformed macros where:

module internal module name, such as bx_posts or system for system calls
action action name (which actually matches module service name but not all service calls are available to use for macros for security reasons)
params JSON encoded string of parameters to pass to the call, which also matches parameters for the service call, params can be omitted if there is no parameters for the service call or parameters are optional
class class name, in most cases it can be omitted

Permissions

Using macros is available for Administrators and Moderators only, but can be enabled for other levels by enabling Use Macros action in Studio > Permissions

Known issues

Sometimes content which is inserted via macros need to load additional CSS and JS files, so it could not work correctly in some places where content is loaded dynamically, for example in Timeline. So it's better to not use macros in regular posts, the better place to use macros is in page builder blocks. Also it can be used in Wiki blocks, but Wiki blocks sometimes are reloaded dynamically when editing, so it maybe issues during Wiki editing. So editor need to know this, this is the reason it's enabled for Admins and Moderators by default.

Sample macros calls

Show join form and online users count.
Add HTML block via Studio > Pages with the following content:

<h2>There are 5 online users on the site, join the site to talk to them:</h2>
                
                
                    
                    
                        
    

    
                                            Account name*
                        
            

    
                                            Email*
                        
            

    
                                            Create a password*
                        

            

    
                    
    
    
                            Receive Newsletters
                                

    
                                            Security Image*
                        
            

    
                                        
            
 
  


                    
                
                
                
    
    By signing up, you agree to the Terms of Service and Privacy Policy.

Publicly show site stats.
Make a forum post with the following content:

Hi, look at my site stats:

Please note this post will not look correct if post is loaded in some dynamic content, like 2nd or more page in Timeline.

List all albums from particular country.
Add wiki block with the following content:

Beautiful Australia

    
        
            Random Musings
        
        
            
                
    
        
     · 
    
        2016-09-18T02:44:04+0000
    






    
        

     · 
    
        Andrey Yasko
    





    


            
        
        Sharing everything we do, plan and think. In a not-too-formal way.  
    
    
        
            
                
                    
                    
                        
                    
                    
                        02:27

As previously noted it may not look good after block adding since it requires additional CSS/JS files, but after page reload it should look fine.

List of macros for UNA 11.0.0

Albums

API

Error: malformed macros

Channels

Contact

Error: malformed macros

Conversations

Discussions

ElasticSearch

Error: malformed macros
Error: malformed macros

Events

Files

Glossary

Groups

Invitations

Error: malformed macros
Error: malformed macros
Error: malformed macros

Market

Notifications

Error: malformed macros

Organizations

Paid Levels

Error: malformed macros
Error: malformed macros
Error: malformed macros

Payment

Error: malformed macros
Error: malformed macros
Error: malformed macros
Error: malformed macros
Error: malformed macros
Error: malformed macros

Persons

Photos

Polls

Posts

Quote of the Day

Error: malformed macros

Shopify

Snipcart

Spaces

System

Timeline

Videos

Wiki

Error: malformed macros
Error: malformed macros
Error: malformed macros

2022-10-21T08:58:30+0000

Overview

Getting Started

Configuration

Administration

Core Apps

Premium Apps

Template Apps

Integration Apps

Development

Macros

Permissions

Known issues

Sample macros calls

List of macros for UNA 11.0.0

Ads

Albums

API

Channels

Contact

Conversations

Discussions

ElasticSearch

Events

Files

Glossary

Groups

Invitations

Market

Notifications

Organizations

Paid Levels

Payment

Persons

Photos

Polls

Posts

Quote of the Day

Shopify

Snipcart

Spaces

System

Timeline

Videos

Wiki