A portal is a branded UI theme on top of the NetX platform that leverages your existing assets to promote your organization’s identity. As a brand manager, creative director, or marketer, you can create content pages to present brand guidelines and detail your vision around color, typography, patterns, logos, links and more.
Creating a portal
- Log on as an Administrator, navigate to the Systems area of your instance and click the Portals tab.
- When prompted, name your new portal. This name can be changed later but your initial name will determine your portal's URL. As you type your portal's name, you will see a preview of the URL.
- Click Save to create your new portal.
Once you have named and saved a portal, you will be taken to the portal Settings tab where you will set the foundations for your new portal.
Name: This is the name you gave your portal upon creation and may be edited here.
- URL: The portal's URL. On creation, this URL will be automatically generated based on the portal's name though it may be edited here.
- Set home route: This is the landing page for your Portal. A blank home page will be created along with your portal. This page may be edited via the pages section, and this home page can be changed once other pages are created.
- User level: This setting determines the user level for self-registered users (if your registration system requires administrator approval, they can change the level during approval). If self-registration does not require administrator approval, it's important to set the permissions on the portal folder to all, or new users will not be able to view your portal's content. Administrators that approve self-registered users before allowing access can determine the proper group for the user during the approval process.
- Logout URL: If you provide a URL here, your portal will automatically redirect any user who performs a logout action. Without a value in this field, your users will be directed back to the main login page.
Contact message: All portals are created with a Contact link in their header. This allows users to communicate with their administrators from within the app itself. If you want to provide a message for your users, such as instructions for what information to include in the contact form, add that here. A recipient email address must be configured using this property.
- Require login: This toggle is not active unless you've configured a public user for your NetX instance. If turned off, authentication will not be required to access your Portal. Anonymous user access and permissions depend on the public user's user level and permissions.
assets tab of your new portal, including any subfolders. This should be set to the topmost folder level your portal users have access to, but does not have to be the same as your NetX instance's top-level folder. Creating a separate folder structure for any portal assets is highly recommended and will simplify permissions for your portal users.Folder : This is the folder displayed in the
Toggling Display folder descriptions will allow your users to read any folder descriptions saved in NetX as hover text.
Access to assets in this named folder is not granted automatically; portal users must be granted permission to view any portal content. For example, if you want portal users to access all portal content, permit them to view this named folder, then make sure the recursive checkbox is checked to include its subfolders. For more information on permissions, see managing permissions.
- Search folder : Searches in your Portal will be performed on this folder and its subfolders. This value is independent of the Folder value, and any permissions granted to this folder will still be respected.
- Display folder descriptions: If this box is checked, descriptions applied to NetX folders will display as hover text on any folders which appear on your portal's pages.
- Replace search placeholder: With this enabled and a value saved, your search bar will update the default Search... placeholder text in the input box.
Google analytics: Toggling this on will enable Google Analytics tracking. To sign up for a Google Analytics tracking ID, see Google's documentation .
asset detail page. Click into the Add attribute field to begin adding attributes. Select attributes via the drop-down list, or type the name of the attribute into the filter field to quickly narrow your results. As attributes are added, they will be added to the bottom of the attribute list. The default attributes shown in the portal are Name, File size, File format, and Resolution. If you customize the list of attributes here, the default attributes will no longer appear on asset detail pages automatically and must be added manually. These attributes appear in the order in which they are set here; you can use the drag button to reorder them. The topmost listed attribute will also appear under assets in various gallery views.Asset detail attributes: Here you can customize the attribute data available from an asset's
SSO: If your instance has an SSO configuration, you can apply those settings to your portal here. Use the full URL of your NetX instance, including https:// to set your portal's SSO value.
All logos, favicons, watermarks, and fonts must be permitted to all portal users – or else they will not be able to view these resources. Consolidating this content into one folder structure with a recursive permission applied to all potential portal users is highly recommended for the sake of simplicity and consistency. For information regarding permissions setup, see managing permissions.
- Logo: To choose a logo asset, begin typing into the input box. Once the asset you are searching for appears in the drop-down, select it and a preview will show in the Logo block. Your logo will appear on all pages of your Portal in the upper-left corner of your portal header.
- Favicon: Select a favicon in the same way you selected a logo asset. This image appears as an icon in your browser tab, along with your portal's title. Note that a pixel dimension of 16x16 or 32x32 is recommended and only PNG, GIF, or ICO files are supported.
- Watermark: If you select a watermark to use in your portal, it will be superimposed over all assets included in your portal library, for all users — including any banners or Adbuilder templates. Choosing a watermark follows the same process as selecting a favicon or logo. Note that you cannot change the opacity of your watermark once it is uploaded into NetX, so any adjustments to your image must be made before upload. Below the image selection field, you can determine where the watermark is placed on assets, including bottom left, bottom right, center (overlay), top left, and top right.
Colors: Here you can assign a primary color for your portal. To choose a color, either type your hex-code color selection or use the primary color field which automatically fills in the appropriate color code. White is not a supported primary color.
- Font: To choose a custom font for your Portal, upload your font file to NetX and type the asset name into the input box. If a user does not have permission to view your font file, the default Portal font will be used instead. Secondly, you can include a Copyright for your Portal with a custom message and date that will appear in all page footers.
- Logout URL: Apply a logout URL to redirect users to that URL when they perform a log out action. Prefacing the URL with https:// is required.
- Copyright: This a copyright message that displays on all page footers.
Portal users must be granted access to page content such as assets, carousels, collections, folders, or folder assets. Consolidating this content into one folder structure with a recursive permission applied to all portal users is highly recommended. For information regarding permissions setup, see managing permissions. Note: this content can be separate from the folder used under your portal's visibility settings .
The P ages tab contains a list of existing pages, the option to create new pages, as well the ability to delete or edit a page. To create a new page:
- Open the action menu, and click Add page.
- Name your new page. Note that the name of your page will automatically populate the page's slug, but the slug may be editing independently from the page title.
- Choose whether your title will be displayed by using the Show page title checkbox. If checked, the title of the page will display in both the portal editor and the portal page itself. This option will not affect the page title's display as a link in the header or footer menu , and can be changed later.
- Click Create.
- Select a template layout; you will have the opportunity to edit this choice later. If you do not select a template while creating the page, Template 1 will be used as the default.
- After you have chosen a template, you will be taken to your new page where you will see a screen with the title of your page, an empty content block that conforms to your template type, and an action menu.
Each content block will be labeled with its type, display a content preview, and provide options to delete or edit the block. Upon creation, blocks will default to an HTML type; this can be changed from the drop-down menu to the left each block's Cancel and Save buttons. Choices include Asset, Carousel, Collection, Folder, Folder Assets, HTML, and Divider, which are described in more detail below.
The action menu along the upper-left corner of the page editor offers the following actions:
- Add block: Adds a new block that will conform to your chosen template selection.
- Page options : Allows you to change both the title and the slug of the page. Additionally, you can choose whether or not the title will be visible on the page.
- Choose template : Changes the template format of the current page.
- Preview: Shows the live portal page.
Asset blocks show exactly one asset at a time, presented according to your chosen template block and the following criteria:
Asset: Type the name of an asset you wish to place in your block and select the asset from the subsequent drop-down menu.
Target: The availability of the Target field will depend upon your asset type. For example, image assets can display in Thumbnail, Preview or Original size. Note that your image will conform to the chosen template block sizing — if you choose an Original size for a smaller block, the full size of the asset may not be reflected on your portal's page. You will be able to preview its size on your page's preview/setup window. Other asset types such as audio or video will not have a target drop-down and will only be available as asset Originals, again conforming in size to the template block of your choice.
Display asset name: The asset name can appear above or below your image, or not at all.
Download/collection buttons : If you wish this asset to be downloadable/collectible by your users, you can toggle these actions here. This will enable hover actions over your asset, though the available actions will be limited to this configuration. If the Collection button is enabled, users will be able to add the asset to a collection. If Download is enabled, users will be able to download and share the asset in question. The option to view an asset's detail page will always be presented as a hover action if either action is enabled.
Link URL/link title: Including a URL with your asset provides an accompanying link beneath the asset content. Applying a link title will change the clickable text that appears in the portal.
This is how the completed asset block from above will look and function on your actual portal page once settings have been saved:
The recommended size for carousel images is 1100x290 pixels to avoid cropped or distorted content.
Carousel content will pull all assets from a selected folder and present each one across a single template block in five-second intervals. Users can manually cycle through these images with navigational arrows. To set up a carousel:
- Type the desired folder name into the input block.
- Content will automatically appear according to the template block sizing it is inserted into. Once your folder has been selected, the page's preview will be updated and the carousel will appear in your portal.
- Click Save when finished.
By default, Browser level users cannot see carousel content. If your public user is a browser and you would like them to view carousel content, see Allow Browsers Access to Carousel Content. Note that regular (non-public) browser users will still not be able to see the content after configuring the property mentioned in that article.
Collection blocks present a gallery of assets from a chosen collection. To create a collection block:
- Type the name of the desired collection and select it from the drop-down list.
- Once you have selected your collection, the page's preview will update to display the collection as a series of thumbnails according to your chosen block's sizing.
- Click Save when finished.
Folder blocks display a clickable folder object that reveals the assets contained within.
Folder blocks will show any subfolders the named folder may have. No assets will display for the chosen folder, but clicking a subfolder object will take you to a gallery of its contents similar to the assets tab, which will include search facets and gallery controls. If your folder has no subfolders, no content will be displayed. The chosen folder will not display as a clickable image.
- Choose the parent folder your folder block will point to; a drop-down of relevant folders will appear as you begin to type.
- After selecting the desired folder, its subfolders will appear as clickable objects according to your chosen template block's sizing. These objects will either appear as placeholder folders or show the folder image if there is one configured for the folder in question, or if your site is set up to automatically assign image thumbnails to folders. Any folder descriptions will appear to users as they hover over the images. Note that these descriptions will only appear if you have enabled them for your portal. Clicking on a folder will load its assets into the portal gallery.
- Click Save when finished.
Folder asset blocks display the assets contained in the chosen folder as a gallery, contained in the selected folder block according to your page's template type.
Not all sizing option types will be supported for non-image assets. While thumbnails will always display (using placeholder thumbnail images if no others are available), file types without preview files will not display if Preview is selected, and only image assets will appear if you select Original. Any unsupported types for any selected size option will leave a gap in the gallery.
To create a folder asset block:
- Begin typing a folder name into the input box, and choose from the drop-down that will appear as you type.
- Choose the size of your assets (thumbnail, preview, or original sizing), whether hover actions will be available, and whether or not to give your folder gallery a title. You can also choose whether or not the asset's name will appear beneath each asset. Note that subfolders will not be displayed, and if your chosen folder is empty, you will not see any content in your block.
- Click Save when finished.
Unlike the prior content box options which rely on NetX data to populate content, HTML content is built by administrators during portal construction to add custom text to your portal. This content displays according to your template type and chosen block's sizing. HTML text will use your portal's custom font (if configured).
To create an HTML block, type and format your text in the HTML editor and click Save when finished.
This last style of content box is very straightforward. Selecting this will place a grey horizontal bar, dividing your content on the page. This option has no configuration options and you can click Save to implement your content divider.
The assets page is shown by default in a new portal's header menu; its contents (including subfolders) are determined by the top-level visibility settings found in the settings tab. This special page differs from a folder asset or collection block in that it allows navigation between any existing subfolders, displays search facets , and offers gallery customization tools such as sorting and a slider to expand each thumbnail's size. Hover actions are available for all assets. The assets page is not editable via the Pages tab in your portal settings but can be removed in the Links tab.
Using the Links tab in portal settings, you can create links to add to your portal's header menu. External links or direct links to assets and folders in NetX are supported.
To add a link:
- In the Links tab, click on the action menu and select Add link.
- Select the link type, then configure a target and a label (the link text which will appear in the header menu). See below for a list of link types.
- Click Save to create the link.
You can use the link's menu to edit or delete the link. Note that Action type links will not be deletable. Any new links will appear as options in the Menu tab where you can add them to your portal's header navigation.
Action: actions are specialized links to internal portal functions, such as AdBuilder templates, the contact form, or the Assets page. Available options include
- adBuilder:templates:route : Adds a link to the AdBuilder product.
- app:contact : Sets up a link to a contact form for communication with a portal manager.
- cms:route:category:roots : Creates a link to the Assets page.
Asset: Asset link types create a direct link to a specific asset. To create an asset link, type the name of the asset into the Asset field, then select the relevant asset from the drop-down menu. You can customize the link's label, which is the text visible in the portal's header.
Folder: Folder links navigate to specific folders, which are displayed similarly to the Assets page. To create a folder link, type the name of the desired folder into the Folder field and select the correct folder from the drop-down menu. You can customize the link's label, which is the text visible in the portal's header.
URL: You can link to other sites directly from your portal header using a URL type link. To add an external link, type the address of the desired site and then give it a label to display in the portal header. Make sure to include http:// or https:// as the link's prefix or your link will not work.
The menus tab consists of two sections: on the right, all of the created links ; on the left, the links which are shown in your portal header.
- To create or edit your header navigation: drag any item from the list on the right to the list on the left. A submenu allows you to include child links under a single header link, and you can also customize the name of your submenu item.
- To create a new submenu drag a Submenu item from the right to the left area, then place any number of links underneath your submenu item. These items should be tabbed to the right so you can see they are part of the submenu. You cannot create a Submenu within a Submenu.
- The order you place your links will be reflected in your navigational bars, with the topmost items occupying the leftmost position.
- To rearrange your menu items, use the
While enabling a public user will allow anonymous users to access your portal, all collection actions will be disabled for this user – regardless of the user level assigned to your public user.
Assigning this property a username as a value allows you to toggle whether or not your portal requires authentication. The username specified in the value will be the account used for all anonymous access if Require login is disabled in the portal settings . For information on the public user, see Anonymous Access to Portals .
|Valid email address||This is the email address that receives emails sent from the contact form from the portal. More than one address can be used, separated by commas.||No|
|category.autoSetAsset||true / false||If the value of this property is true, a thumbnail will be automatically assigned to each folder based on the asset with the lowest asset ID stored in that folder. This image will appear when viewing folder type blocks without the need to manually add an image to a folder, though any image assigned to a folder manually will override this default. If the value of this property is false, folders will only receive images in a portal when they are manually added to a folder.|