2016-06-21 11:35:09 +00:00
|
|
|
module Banzai
|
2016-10-06 21:52:44 +00:00
|
|
|
# Class for rendering multiple objects (e.g. Note instances) in a single pass,
|
|
|
|
# using +render_field+ to benefit from caching in the database. Rendering and
|
|
|
|
# redaction are both performed.
|
2016-06-21 11:35:09 +00:00
|
|
|
#
|
2016-10-06 21:52:44 +00:00
|
|
|
# The unredacted HTML is generated according to the usual +render_field+
|
|
|
|
# policy, so specify the pipeline and any other context options on the model.
|
|
|
|
#
|
|
|
|
# The *redacted* (i.e., suitable for use) HTML is placed in an attribute
|
|
|
|
# named "redacted_<foo>", where <foo> is the name of the cache field for the
|
|
|
|
# chosen attribute.
|
|
|
|
#
|
|
|
|
# As an example, rendering the attribute `note` would place the unredacted
|
|
|
|
# HTML into `note_html` and the redacted HTML into `redacted_note_html`.
|
2016-06-21 11:35:09 +00:00
|
|
|
class ObjectRenderer
|
|
|
|
attr_reader :project, :user
|
|
|
|
|
2016-10-06 21:52:44 +00:00
|
|
|
# project - A Project to use for redacting Markdown.
|
2016-06-21 11:35:09 +00:00
|
|
|
# user - The user viewing the Markdown/HTML documents, if any.
|
2016-10-06 21:52:44 +00:00
|
|
|
# context - A Hash containing extra attributes to use during redaction
|
|
|
|
def initialize(project, user = nil, redaction_context = {})
|
2016-06-21 11:35:09 +00:00
|
|
|
@project = project
|
|
|
|
@user = user
|
2016-10-06 21:52:44 +00:00
|
|
|
@redaction_context = redaction_context
|
2016-06-21 11:35:09 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
# Renders and redacts an Array of objects.
|
|
|
|
#
|
2016-10-06 21:52:44 +00:00
|
|
|
# objects - The objects to render.
|
2016-06-21 11:35:09 +00:00
|
|
|
# attribute - The attribute containing the raw Markdown to render.
|
|
|
|
#
|
|
|
|
# Returns the same input objects.
|
|
|
|
def render(objects, attribute)
|
2016-08-24 17:11:48 +00:00
|
|
|
documents = render_documents(objects, attribute)
|
|
|
|
documents = post_process_documents(documents, objects, attribute)
|
2016-06-21 11:35:09 +00:00
|
|
|
redacted = redact_documents(documents)
|
|
|
|
|
|
|
|
objects.each_with_index do |object, index|
|
2016-07-04 05:31:43 +00:00
|
|
|
redacted_data = redacted[index]
|
2016-10-06 21:52:44 +00:00
|
|
|
object.__send__("redacted_#{attribute}_html=", redacted_data[:document].to_html.html_safe)
|
2016-07-04 05:31:43 +00:00
|
|
|
object.user_visible_reference_count = redacted_data[:visible_reference_count]
|
2016-06-21 11:35:09 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2016-08-24 17:11:48 +00:00
|
|
|
private
|
|
|
|
|
|
|
|
def render_documents(objects, attribute)
|
|
|
|
pipeline = HTML::Pipeline.new([])
|
|
|
|
|
|
|
|
objects.map do |object|
|
|
|
|
pipeline.to_document(Banzai.render_field(object, attribute))
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
def post_process_documents(documents, objects, attribute)
|
|
|
|
# Called here to populate cache, refer to IssuableExtractor docs
|
|
|
|
IssuableExtractor.new(project, user).extract(documents)
|
|
|
|
|
|
|
|
documents.zip(objects).map do |document, object|
|
|
|
|
context = context_for(object, attribute)
|
|
|
|
Banzai::Pipeline[:post_process].to_document(document, context)
|
|
|
|
end
|
2016-06-21 11:35:09 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
# Redacts the list of documents.
|
|
|
|
#
|
|
|
|
# Returns an Array containing the redacted documents.
|
|
|
|
def redact_documents(documents)
|
|
|
|
redactor = Redactor.new(project, user)
|
|
|
|
|
2016-07-04 05:31:43 +00:00
|
|
|
redactor.redact(documents)
|
2016-06-21 11:35:09 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
# Returns a Banzai context for the given object and attribute.
|
|
|
|
def context_for(object, attribute)
|
2016-08-24 17:11:48 +00:00
|
|
|
base_context.merge(object.banzai_render_context(attribute))
|
2016-06-21 11:35:09 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
def base_context
|
2016-08-24 17:11:48 +00:00
|
|
|
@base_context ||= @redaction_context.merge(
|
|
|
|
current_user: user,
|
|
|
|
project: project,
|
|
|
|
skip_redaction: true
|
|
|
|
)
|
2016-06-21 11:35:09 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|