Skip to main content
Version: 5.4

Customize Views

Each page & template is fully customizable to your brand's design. All View Options are optional, there are Mealz defaults for each view.

info

To understand how to create a custom component, you can read here.

We recommend putting all of your custom ViewOptions into a custom class. In our sample implementations, we have one class MealzViewConfig, however you may find it more maintainable to have multiple classes.

import MealziOSSDK

struct MealzViewConfig {
// the below View Options go here
}

Base Views​

View Options​

Base Views - BasePageViewParameters​

import MealziOSSDK

static let baseViews = BasePageViewParameters(
    loading: TypeSafeLoading(/* your new view*/),
    empty: TypeSafeEmpty(/* your new view*/),
    background: TypeSafeBackground(/* your new view*/)
)

Components:

My Meals Options​

View Options​

MyMeals - MyMealsViewOptions​

import MealziOSSDK

static let myMealsViewOptions = MyMealsViewOptions(
    recipeCard: TypeSafeMyMealRecipeCard(/* your new view*/),
    recipeCardLoading: TypeSafeRecipeCardLoading(/* your new view*/)
)

Protocols:

My Meals Grid Config - 'myMealsRecipesListGridConfig'​

import MealziOSSDK

static let myMealsDefaultRecipesListGridConfig = CatalogRecipesListGridConfig(
    numberOfColumns: 1, 
    recipeCardDimensions: CGSize(width: 300, height: 180)
)

My Meals Feature Constructor​

MyMealsFeatureConstructor(
    baseViews: myMealsBaseViews, // or you can pass in BaseViews from the Catalog or another Feature
    myMealsViewOptions: myMealsViewOptions,
    catalogRecipesListGridConfig: myMealsDefaultRecipesListGridConfig,
    navigateToCatalog: {/* on the standalone Feature, you must implement this */}
)

Recipe Details Options​

View Options​

Recipe Details - RecipeDetailsViewOptions​

import MealziOSSDK

static let recipeDetailsViewOptions = RecipeDetailsViewOptions(
    floatingHeader: TypeSafeRecipeDetailsFloatingHeader(/* your new view*/),
    header: TypeSafeRecipeDetailsHeader(/* your new view*/),
    tags: TypeSafeRecipeDetailsTags(/* your new view*/),
    sponsor: TypeSafeRecipeDetailsSponsor(/* your new view*/),
    selectedControl: TypeSafeRecipeDetailsSelectedControl(/* your new view*/),
    ingredients: TypeSafeRecipeDetailsIngredients(/* your new view*/),
    steps: TypeSafeRecipeDetailsSteps(/* your new view*/),
    footer: TypeSafeRecipeDetailsFooter(/* your new view*/),
    ingredientsAtHomeToggleButton: TypeSafeBaseButton(/* your new view*/),
    unavailableIngredientsToggleButton: TypeSafeBaseButton(/* your new view*/),
    ingredientsAtHome: TypeSafeNotInBasketProduct(/* your new view*/),
    unavailableIngredients: TypeSafeNotInBasketProduct(/* your new view*/)
)

Components:

Products - RecipeDetailsProductViewOptions​

import MealziOSSDK

static let recipeDetailsProductViewOptions = RecipeDetailsProductViewOptions(
    ignoredProduct = TypeSafeRecipeDetailsIgnoredProduct(/* your new view*/),
    unaddedProduct = TypeSafeRecipeDetailsUnaddedProduct(/* your new view*/),
    addedProduct = TypeSafeRecipeDetailsAddedProduct(/* your new view*/),
    loadingProduct = TypeSafeLoading(/* your new view*/)
)

Components:

Item Selector - ItemSelectorViewOptions​

import MealziOSSDK

static let itemSelectorViewOptions = ItemSelectorViewOptions(
    searchBar = TypeSafeSearch(/* your new view*/),
    title = TypeSafeBaseTitle(/* your new view*/),
    selectedProduct = TypeSafeItemSelectorSelectedProduct(/* your new view*/),
    productOptions = TypeSafeItemSelectorOptionProducts(/* your new view*/),
    noResults = TypeSafeItemSelectorNoResults(/* your new view*/)
)

Protocols:

Recipe Details Constructor​

RecipeDetailsFeatureConstructor(
    baseViews: recipeDetailsBaseViews, // or you can pass in BaseViews from the Catalog or another Feature
    recipeDetailsViewOptions: recipeDetailsViewOptions,
    recipeDetailsProductViewOptions: recipeDetailsProductViewOptions,
    itemSelectorViewOptions: itemSelectorViewOptions
)

Putting it All Together​

import MealziOSSDK

public let mealzMyMealsFeature = MealzMyMealsFeatureUIKit(
    recipeDetailsConstructor: MealzViewConfig.recipeDetailsConfig,
    myMealsFeatureConstructor: MealzViewConfig.myMealsConfig
)