As of: Winter '22

Authored By: George Abboud

Last Updated: 02/08/2022

Reviews and Contributions:

Manish Aggarwal

AppExchange Listing: https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FZFTAUA5

Open-Source Code: https://github.com/salesforce-experiencecloud/KnowledgeArticleBodyContent

The Article Body app has components that allow for displaying the rich text content of both lightning and classic knowledge articles, instead of the standard page layout display that shows more fields than potentially needed. The Lightning Knowledge component provides querying options by recordId, urlName, or articleNumber. Both the Lightning and Classic Knowledge components provide options to show/hide/style the Title, Article Number, and Total Number of Views, as well as showing / hiding voting capabilities for authenticated users is also possible.

This package is free to use, but is not an official salesforce.com product, and should be considered a community project. The functionality is not officially tested or documented, and does not come with any support, warrantees, or updates. It is offered as-is.

Configure the custom metadata type “Article Body Setting” for Lightning:

• Go to Setup > Custom Metadata Types
• Next to Article Body Setting, click “Manage Records”
• You should see a record with a Label called “lightning”, click Edit next to that and enter the article object API name for that article. Example: Knowledge__kav
  • 
• Then enter the API name for the Rich Text Area field(s) that contains the content / body of the article. Example: Body__c. For multiple fields, separate the API names with a comma, Example: Body__c, Summary__c, etc.
  • 
• Click Save

Configure the Article Body - Lightning component in Community Builder as follows:

Component Label: Article Body - Lightning Component Aura API Name: articleBody Component LWC API Name: article-body Component Namespace: articleBody Component Properties:

<articleBody:articleBody 
    queryBy="{!v.queryBy}" 
    articleAPIName="{!v.articleAPIName}" 
    articleBodyAPIName="{!v.articleBodyAPIName}" 
    articleBodyAPIName2="{!v.articleBodyAPIName2}"
    showSecondBodyField="{!v.showSecondBodyField}"
    showTitle="{!v.showTitle}"
    recordId="{!v.recordId}" 
    urlName="{!v.urlName}" 
    articleViewsText="{!v.articleViewsText}" 
    articleViewsStyle="{!v.articleViewsStyle}" 
    showArticleViews="{!v.showArticleViews}"
    showTopics="{!v.showTopics}"
    showVoting="{!v.showVoting}"
    replaceSmartLinks="{!v.replaceSmartLinks}"
    smartLinksUrlPath="{!v.smartLinksUrlPath}"
    articlePageUrl="{!v.articlePageUrl}"
/>

Configure the custom metadata type “Article Body Setting” for Classic:

• Go to Setup > Custom Metadata Types
• Next to Article Body Setting, click “Manage Records”
• Select New and fill out the form setting the Label, Identifier, and Article API Name Whitelist fields to the Article Type’s API name. Example: FAQ__kav
  • 
• Set the Article Body Field API Name to the API name of the Rich Text Area field(s) on the article that contains the Content / Body of the article. For multiple fields, separate the API names with a comma, Example: Body__c, Summary__c, etc.
  • 
• Click Save

Configure the Article Body - Classic component Community Builder as follows:

Component Label: Article Body - Classic Component Aura API Name: articleBodyClassic Component LWC API Name: article-body-classic Component Namespace: articleBody Component Properties:

Note 1: You have to explicitly grant access to the following apex controller for every profile that will be running this component, including the guest user profile: articleBody__ArticleController

Note 2: This app is LWR-Ready!

Installation URL: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5w000004ciMz

• Added support for Smart Links
• Fix for voting methods resulting in query errors

Installation URL: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5w000005CsSb

• Fix for displaying articles in draft. Only system administrators or user with modify all data permissions can view draft articles now. Otherwise the article must be published to display in the component.

Installation URL: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5w000005CrMC

• Fixes to update view stat counts on articles when queried

Installation URL: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5w000005CrM7

• Added support to display an optional second rich text field, below the first required one.
• Added support to show assigned topics
• Added RelaxedCSP Capability

Installation URL: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5w000000asSi

• Updated controller to global due to issue with recent security update that does not allow granting permission to lightning controllers in managed packages, unless they’re declared as global.

Installation URL: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5w000002lCMk

• Fixed issue with inability for the guest user to query the Vote object. Query was not necessary for guest users.

Installation URL: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5w000002kN2P

• Added disable-linkify on formatted rich text that handles displaying article body / html content. Linkifying was causing issues with formatted code in article content.

Installation URL: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5w000002kEJ6

• Added separate component for Classic Knowledge, with controller changes to support that.

Installation URL: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5w000002kEJ1

• Fixed default custom metadata type article API Name value

Installation URL: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5w000002kChq

• Moved custom labels to custom metadata types for ease of modification in subscriber org

Installation URL: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5w000002k9RH

• Initial Release