Skip to main content

app-aliases

App Aliases​

What is an app alias?​

An app alias allows the creation of up multiple apps that are simply presets or slight variations of another app. Eg. Contact Form and Survey are both aliases of Form Builder. The primary purpose of an alias is for SEO, and to provide users with Apps that immediately meet their needs, while not sacrificing the full customization power of POWr!

How to create a HARD app alias​

  • An app alias does NOT have js, css, or template files
  • It DOES have a javascript model, this should be added to the parent app (eg paypalButton.js)
    • Example: window.stripeButtonAppModel = window.paypalButtonAppModel;
  • When creating an AppDetail, be sure to set the alias property as the app name of the parent app (eg 'formBuilder')
  • Other than this, the AppDetail, Docs, changes to Application.rb and powr.js should be performed just like a normal app, please see the 'creating an app' wiki page! (ie Ignore the "assets" and "templates" section, but do the rest)
  • Note that hard app aliases DO appear in the POWR Mini Market - they will be displayed by category and priority.

Customizing content based on the app alias​

  • Within a template file, you can render or hide content based on the @app['app_type'] parameter. This will be different for the different app aliases
  • Within javascript, you can similarly access the model property (app_type) for app-specific logic

Adding new aliases for Popup and Chat app​

If you add new alias for popup and chat app, please make sure to add appSlug to powr.js file on isPopup() and isChat() so it can work properly.

Example: I'm creating a new alias for popup called myNewPopup and the appSlug is going to be my-new-popup. You will need to add my-new-popup to the array that is already in isPopup() method.

Adding a SOFT alias​

Soft aliases are more simple... they are created entirely by an admin in POWR. These can be made quickly and easily for any use case.

  • As an admin in POWR, create and customize an app that you would like to use as the basis for the new soft template... for example a Super Bowl Poll
  • Once the app is how you like it, click on the admin button in the topbar
  • in the field for Generate a soft alias - enter the name you would like to use for the new soft alias - This should be entered as a human readable name, so use spaces and no dashes or underscores
  • click generate and you should be good to go
  • I believe there is no way to update these, you would simple save over an existing one to make changes.