module Scrivito
  #
  # The helper contains methods to generate URLs to CMS content.
  # Use {Scrivito::RoutingHelper#scrivito_path} or {Scrivito::RoutingHelper#scrivito_url} when linking or
  # redirecting to CMS objects. These methods are available in boths your views and your controllers.
  #
  # @api public
  #
  module RoutingHelper
    #
    # Returns the (URL-)path for a cms object.
    #
    # @api public
    #
    # @param target [Obj, Link, Array<Link>, Binary]
    #   If +target+ is an +Array+ of +Links+, it must be non-empty.
    #   The first {Link} from the +Array+ will be used.
    # @param options [Hash] include url settings such as path parameters or protocol.
    #
    # @return [String]
    #
    def scrivito_path(target, options = {})
      CmsRouting.new(request, main_app, scrivito_engine).path_or_url(target, "path", options)
    end

    #
    # Returns the absolute URL for a cms object.
    #
    # @api public
    #
    # @param target [Obj, Link, Array<Link>, Binary]
    #   If +target+ is an +Array+ of +Links+, it must be non-empty.
    #   The first {Link} from the +Array+ will be used.
    # @param options [Hash] include url settings such as path parameters or protocol.
    #
    # @return [String]
    #
    def scrivito_url(target, options = {})
      CmsRouting.new(request, main_app, scrivito_engine).path_or_url(target, "url", options)
    end
  end
end