Placeholders

String placeholders

Placeholders sets the <Dictionary<String, String>> like ["<key>" : "<value>"].

"<key>" of placeholder sets without symbols "%".

1. Placeholders can be set after initializing the library with setting and before creating the StoryView/StoryListView.

AppDelegate.swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool
{
    // library settings object
    let settings = Settings(userID: <String>, tags: <Array<String>>)

    // library initialization
    InAppStory.shared.initWith(serviceKey: <String>, settings: settings)

    // dictionary of placeholders like ["<key>" : "<value>"]
    InAppStory.shared.placeholders = <Dictionary<String, String>>

    return true
}

2. Also, placeholders can be set or change in portions after creating the StoryView/StoryListView. For the changes to take effect, you need to update the list (see Refresh)

tip

Onboarding and singles can also use placeholders, but you don't need to call refresh() on the list to update them. The main thing is to set their value before calling the onboarding or single display.

UIKit

ViewController.swift

var storyView: StoryView!

override func viewDidLoad() {
    super.viewDidLoad()

    storyView = StoryView(frame: CGRect(x: 0.0, y: 100.0, width: 320.0, height: 160.0)) //initialize StoryView
    view.addSubview(storyView) //add object to the view

    storyView.create() //running internal logic
}

// calling after StoryView is created
func setPlaceholders() {
    InAppStory.shared.placeholders = <Dictionary<String, String>> // set placeholders values

    storyView.refresh() //updating story list
}

tip

While setting placeholders, it's a good idea to make sure they're up to date before calling refresh(). You can also call refresh() right after the placeholder update methods.

SwiftUI

ContentView.swift

struct ContentView: View
{
    /// variable responsible for refreshing the list
    @State var isListRefresh: Bool = false

    var body: some View {
        /// set the variable that will be tracked by the list for refresh
        StoryListView(refresh: $isListRefresh)
            .frame(height: 120)
            .frame(maxWidth: .infinity)
    }

    /// new placeholders
    func updatePlaceholders() {
        InAppStory.shared.placeholders = ["new_pl_1" : "new_val_1", "new_pl_2" : "new_val_2"]

        /// if you change the variable to true, the list will be refreshed
        isListRefresh.toggle()
    }
}

tip

While setting placeholders, it's a good idea to make sure they're up to date before calling refresh(). You can also call refresh() right after the placeholder update methods.

Image placeholders

The library allows you to install your own images by replacing placeholders.

Placeholders sets that <Dictionary<String, String>> like ["<key>" : "<value>"].

• "<key>" this is the value of the placeholder that will be replaced with the image, set without the "%" symbol.
• "<value>" is the link to the image that will be substituted in the slide.

Attention!

For links leading to resources on the Internet to work properly, it is necessary for links to begin with https://.
If resources are located in an unsecured repository (http://), you need to specify in info.plist the trusted domains that are allowed to be used using the NSAppTransportSecurity key.

1. Image placeholders can be set during the first initialization with the InAppStory settings:

AppDelegate.swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool
{
    // library settings object
    let settings = Settings(userID: <String>, tags: <Array<String>>)

    // library initialization
    InAppStory.shared.initWith(serviceKey: <String>, settings: settings)

    // dictionary of placeholders like ["<key>" : "<value>"]
    InAppStory.shared.imagesPlaceholders = <Dictionary<String, String>>

    return true
}

2. Also, image placeholders can be set or changed in portions after creating the StoryView. For the changes to take effect, you need to update the list (see Refresh)

tip

Onboarding and singles can also use placeholders, but you don't need to call refresh() on the list to update them. The main thing is to set their value before calling the onboarding or single display.

UIKit

ViewController.swift

var storyView: StoryView!

override func viewDidLoad() {
    super.viewDidLoad()

    storyView = StoryView(frame: CGRect(x: 0.0, y: 100.0, width: 320.0, height: 160.0)) //initialize StoryView
    view.addSubview(storyView) //add object to the view

    storyView.create() //running internal logic
}

// calling after StoryView is created
func setPlaceholders() {
    InAppStory.shared.imagesPlaceholders = <Dictionary<String, String>> // set placeholders values

    storyView.refresh() //updating story list
}

SwiftUI

ContentView.swift

struct ContentView: View
{
    /// variable responsible for refreshing the list
    @State var isListRefresh: Bool = false

    var body: some View {
        /// set the variable that will be tracked by the list for refresh
        StoryListView(refresh: $isListRefresh)
            .frame(height: 120)
            .frame(maxWidth: .infinity)
    }

    /// new placeholders
    func updatePlaceholders() {
        InAppStory.shared.imagesPlaceholders = ["new_img_pl_1" : "new_val_1", "new_img_pl_2" : "new_val_2"]

        /// if you change the variable to true, the list will be refreshed
        isListRefresh.toggle()
    }
}

tip

While setting placeholders, it's a good idea to make sure they're up to date before calling refresh(). You can also call refresh() right after the placeholder update methods.