Creating/Modifying Content Apps
AppManager Content Apps can easily be created or modified within the AppManager based on an existing SharePoint list or by creating a new SharePoint list as the source for the Content App.
The Content App creation modal allows for more than one Content App to be associated with a single SharePoint list. As an example, this could be used to generate two different Content Apps, one of which had access to set the “Start Date” and “End Date” for an article, and another which could only edit the heading and body content. These apps could be assigned to different content editors based on what you wanted each to have access to.
To create a new content app in AppManager, click the +ADD NEW button. To change the settings for an existing content app, click the EDIT pencil icon for Content Apps on the AppManager Settings page.
A list of the existing Content Apps on the current site will be displayed.
To add a new Content App, click on the “+ Add New” button. A modal window will open with the Content App info screen to begin the process.
Complete the Content App info screen using the following information:
| Field | Value |
|---|---|
| App Type |
Supported App Types in AppManager:
For additional information, please reference the following documents: Working with Author Type Content Apps Working with Curated Type Content Apps Working with Quicklinks Type Content Apps Working with Slider Type Content Apps Working with Image Gallery Type Content Apps (see Content section) |
| SharePoint list | This is the name of the SharePoint list which has the content to be managed. |
| App Name | This is the title which will display as part of the Content App icon in AppManager. It does not affect the original SharePoint list title. |
| App Icon | Select the icon you want to use for the App. |
Click on the “Save” button and the Content App settings screen will display for the new app to complete the configuration.
Configure (or update) the settings for the new Content App using the following table as reference:
| Field | Value |
|---|---|
| Authorized Groups & Users | Select one or more SharePoint groups who will have access to this Content App. Click on “Select Groups & Users” to display the list of available groups. |
| Preview | If preview is desired for this app, the pages which will be available are entered here. The Preview Name is what will appear in the preview menu in the Content App. The “Page URL” must be the fully qualified URL for the target page. Multiple preview pages can be defined. See Enabling Preview for the steps to enable the Preview function.
If you would like to PREVIEW a dynamic page such as a News Detail or Interior page or any list with a “FriendlyUrl” column in it then the value for the “Page URL” should be: https://{RootSharePointSiteURL}{{FriendlyUrl}} example: https://example.sharepoint.com{{FriendlyUrl}} This is assuming the FriendlyURL column in the associated Content App SharePoint list is a calculated field which includes the site path. |
| Link resources for content editor | Allows a content editor, using the AppManager rich text editor (ck-editor), to use a friendly link picker to select and set links to text within the editor. The link picker, when “Link to SharePoint list item” is selected, will allow the editor to select from SharePoint lists (with FriendlyUrl)/libraries, configured on this content app via the “Link resources for content editor” definition. Links should be configured to use a FriendlyUrl (used to link to lists with dynamic content) or default (to be used when pointing to a document library. Example:
|
| App Image Library | This is the image library which will be displayed if a user chooses to add an image to the content from the content editor. Consider creating and setting a new Image libraries for a content app, or creating folders within the library to organize the images for a Content App, creating a folder for each content app that this image library supports. |
| SORT Field | Not shown in the image above. This field displays when configuring a Quicklinks or Slider App Type. Clicking on “Select” will display the list columns so that the column that contains the order to display items (DisplayOrder) can be selected. |
| Columns
|
“Hide from App” allows for the hiding of specified fields in the content app. A list may have fields that are not required for the business user to view.
“Display as SEO Field” defines which fields in the list are associated with SEO data. These fields are then grouped together in and SEO section in the Content App. “Enable Auto Translation” defines which fields in the list are allowed to be auto translated when multilingual is enabled. “Re-order” defines the display order for the content app selected. Allows columns to be moved up/down to change the field order display. |
| Custom Settings > Image Source | Only the App Type “Image Gallery”, uses the custom settings area. This field is used to define the source library for the supporting Image Gallery list, example ImageGallery_AK. This the library where the list ImageGallery_AK, will look for the selected images. A Library can be created just to support your Image Gallery. This library should be the same library set for the input field “App Image Library” (which is used to upload images). Example for AppType = ImageGallery:
|
| Enable auto-translate | If using the multilingual capability in the AppManager (Product Feature Key required), this option enables the auto-translate feature for the application. |
| Enable Created by Filter | Turning this on will cause the content listing for the Content App to only display items created by the current logged in user. Regardless of the filtering they choose on the listing page, the results will always be from the set they created. |
| Enable Title Uniqueness Check | This option (normally on) will enforce the title of each content item added in the app to be unique. Since there are circumstances where the title field DOES NOT have to be unique (as can be set in the SharePoint list), setting this to “Off” disables the check in AppManager and allows for duplicate item titles. |
| Enable Personas for this app | Turning this on enables the persona feature to be set for access control based on personas. |
| Enable Social Rules | Turning this on enables which reactions are available and who should be notified for comments and/or reactions associated with this item. (Product Feature Key Required). |
| Enable Comments for this app | Turning this on enables the commenting feature which allows those with access to the Content App to add comments to an item. |
| Hide “Add New” | This option is only available for the Author App Type. Turning this on hides the “Add New” button from the Content App content list, preventing any new content from being created (existing content can still be edited). This is typically used for the Content Block application where only one content item is mapped to the Content Block, so creating a new one without changing the content block control would have no effect. |
| Hide “Delete” | Turning this “ON” hides the “Delete” button from the current app. This is the default setting when creating a new content app of type Author, Slider or File. Turning to “OFF” will display the delete button in the app. |
| Enable Permissions Setting for this app | Turning this on allows read/edit permissions to be set for this app. |
| Enable Content Distribution for this app | Turning this on allows user to push content from portal to market in the app. |
Click SAVE & EXIT when complete.
The Content Apps list will display with the new app added.
At any time, click on the “Edit” pencil icon for the Content App to access and update the settings.
Click on the “Remove” trash can icon to remove an app.
Enabling Content App Permissioning with Save, Publish and Preview Functions
The Save, Publish and Preview buttons displayed to the user on the content app screen are dependent on the users editing permissions and the version settings established for the content app. For details on Enabling Content App Permissioning with Save, Publish and Preview Functions, please visit here.