Post Sharing

Post Sharing Settings

This setting allows you to control where a post can be shared to based on the post origin.

There are five possible targets that a post can be shared to

My feed - The post can be shared to my feed. This option will enable "Share to my timeline" menu when user clicks share button.

Public community - The post can be shared to any public community. This option will enable "Share to group" menu when user clicks share button.

Private community - The post can be shared to any private community. This option will enable "Share to group" menu when user clicks share button.

External - The post can be shared externally. This option will enable "More options" menu when user clicks share button.

Origin - The post can be shared within the community feed that it was created. If the post was created in either public or private community, this option will enable "Share to group" menu when user clicks share button.

There are four possible origins

My feed post - Posts that were created on my feed. By default, possible sharing targets are My feed, Public community, and Private community.

User feed post - Posts that were created on any other users' feed. By default, possible sharing targets are My feed, Public community, and Private community.

Public community feed post - Posts that were created on any public community. By default, possible sharing targets are My feed, Public community, and Private community.

Private community feed post - Posts that were created on any private community. By default, possible sharing target is Origin.

Usage

You can select a set of targets for each post origin.

// In your AppDelegate class

// Ensure post created in private community cannot be shared elsewhere
let privateCommunityShringTargets: Set<AmityPostSharingTarget> = [.originFeed]

// Allow post created by any other user to be shared anywhere
let publicCommunityShringTargets: Set<AmityPostSharingTarget> = [.myFeed, .originFeed, .publicCommunity, .external]

// Allow post created by logged-in user to be shared anywhere
let myFeedShringTargets: Set<AmityPostSharingTarget> = [.myFeed, .originFeed, .external]
        
let sharingSettings = AmityPostSharingSettings(privateCommunity: privateCommunityShringTargets, publicCommunity: publicCommunityShringTargets, myFeed: myFeedShringTargets)
        
AmityUIKitManager.feedUISettings.setPostSharingSettings(settings: sharingSettings)

Post Sharing Events

Based on Post sharing settings, there are up to three post sharing events that can be emitted by UIKit.

Share to my timeline - an event emitted when a user clicks on "Share to my timeline" button.

Share to group - an event emitted when a user clicks on "Share to group" button.

Share externally - an event emitted when a user clicks "More options" button.

Usage

You can choose to intercept one or all of the events and apply your custom behavior.

// In your AppDelegate class

// Create custom event handler class
class CustomFeedEventHandler: AmityFeedEventHandler {
    // Event handler for more options
    override func sharePostDidTap(from source: AmityViewController, postId: String) {
        // generate a link 
        let urlString = "https://amity.co/posts/\(postId)"
        guard let url = URL(string: urlString) else { return }
        
        // create AmityActivityController to share generated link
        let viewController = AmityActivityController.make(activityItems: [url])
        source.present(viewController, animated: true, completion: nil)
    }
    
    // Event handler for share post to group
    override func sharePostToGroupDidTap(from source: AmityViewController, postId: String) {
        // Handle event here
    }
    
    // Event handler for share to my timeline
    override func sharePostToMyTimelineDidTap(from source: AmityViewController, postId: String) {
        // Handle event here
    }
}

...

AmityUIKitManager.feedUISettings.eventHandler = CustomFeedEventHandler()