# Copyright (c) 2008-2013 Michael Dvorkin and contributors.
#
# Fat Free CRM is freely distributable under the terms of MIT license.
# See MIT-LICENSE file or http://www.opensource.org/licenses/mit-license.php
#------------------------------------------------------------------------------
module ApplicationHelper
def tabs(tabs = nil)
tabs ||= controller_path =~ /admin/ ? FatFreeCRM::Tabs.admin : FatFreeCRM::Tabs.main
if tabs
@current_tab ||= tabs.first[:text] # Select first tab by default.
tabs.each { |tab| tab[:active] = (@current_tab == tab[:text] || @current_tab == tab[:url][:controller]) }
else
raise FatFreeCRM::MissingSettings, "Tab settings are missing, please run rake ffcrm:setup command."
end
end
#----------------------------------------------------------------------------
def tabless_layout?
%w[authentications passwords].include?(controller.controller_name) ||
((controller.controller_name == "users") && %w[create new].include?(controller.action_name))
end
# Show existing flash or embed hidden paragraph ready for flash[:notice]
#----------------------------------------------------------------------------
def show_flash(options = { sticky: false })
%i[error warning info notice].each do |type|
if flash[type]
html = content_tag(:div, h(flash[type]), id: "flash")
flash[type] = nil
return html << content_tag(:script, "crm.flash('#{type}', #{options[:sticky]})".html_safe, type: "text/javascript")
end
end
content_tag(:p, nil, id: "flash", style: "display:none;")
end
#----------------------------------------------------------------------------
def subtitle(id, hidden = true, text = id.to_s.split("_").last.capitalize)
content_tag("div",
link_to("#{hidden ? '►' : '▼'} #{sanitize text}".html_safe,
url_for(controller: :home, action: :toggle, id: id),
remote: true,
onclick: "crm.flip_subtitle(this)"
), class: "subtitle")
end
#----------------------------------------------------------------------------
def section(related, assets)
asset = assets.to_s.singularize
create_id = "create_#{asset}"
select_id = "select_#{asset}"
create_url = controller.send(:"new_#{asset}_path")
html = tag(:br)
html << content_tag(:div, link_to(t(select_id), "#", id: select_id), class: "subtitle_tools")
html << content_tag(:div, " | ".html_safe, class: "subtitle_tools")
html << content_tag(:div, link_to_inline(create_id, create_url, related: dom_id(related), text: t(create_id)), class: "subtitle_tools")
html << content_tag(:div, t(assets), class: :subtitle, id: "create_#{asset}_title")
html << content_tag(:div, "", class: :remote, id: create_id, style: "display:none;")
end
#----------------------------------------------------------------------------
def load_select_popups_for(related, *assets)
js = generate_js_for_popups(related, *assets)
content_for(:javascript_epilogue) do
raw "$(function() { #{js} });"
end
end
def generate_js_for_popups(related, *assets)
assets.map do |asset|
render(partial: "shared/select_popup", locals: { related: related, popup: asset })
end.join
end
# We need this because standard Rails [select] turns ★ into ★
#----------------------------------------------------------------------------
def rating_select(name, options = {})
stars = Hash[(1..5).map { |star| [star, "★" * star] }].sort
options_for_select = %()
options_for_select << stars.map { |star| %() }.join
select_tag name, options_for_select.html_safe, options
end
#----------------------------------------------------------------------------
def link_to_inline(id, url, options = {})
text = options[:text] || t(id, default: id.to_s.titleize)
text = (arrow_for(id) + text) unless options[:plain]
related = (options[:related] ? "&related=#{options[:related]}" : '')
link_to(text,
url + "#{url.include?('?') ? '&' : '?'}cancel=false" + related,
remote: true,
onclick: "this.href = this.href.replace(/cancel=(true|false)/,'cancel='+ ($('##{id}').css('display') != 'none'));",
class: options[:class]
)
end
#----------------------------------------------------------------------------
def arrow_for(id)
content_tag(:span, "►".html_safe, id: "#{id}_arrow", class: :arrow)
end
#----------------------------------------------------------------------------
def link_to_edit(record, options = {})
object = record.is_a?(Array) ? record.last : record
name = (params[:klass_name] || object.class.name).underscore.downcase
link_to(t(:edit),
options[:url] || polymorphic_url(record, action: :edit),
remote: true,
onclick: "this.href = this.href.split('?')[0] + '?previous='+crm.find_form('edit_#{h name}');".html_safe
)
end
#----------------------------------------------------------------------------
def link_to_delete(record, options = {})
object = record.is_a?(Array) ? record.last : record
confirm = options[:confirm] || nil
link_to(t(:delete) + "!",
options[:url] || url_for(record),
method: :delete,
remote: true,
confirm: confirm
)
end
#----------------------------------------------------------------------------
def link_to_discard(object)
current_url = (request.xhr? ? request.referer : request.fullpath)
parent, parent_id = current_url.scan(%r{/(\w+)/(\d+)}).flatten
link_to(t(:discard),
url_for(controller: parent, action: :discard, id: parent_id, attachment: object.class.name, attachment_id: object.id),
method: :post,
remote: true
)
end
#----------------------------------------------------------------------------
def link_to_cancel(url, params = {})
url = params[:url] if params[:url]
link_to(t(:cancel),
url + "#{url.include?('?') ? '&' : '?'}cancel=true",
remote: true
)
end
#----------------------------------------------------------------------------
def link_to_close(url)
link_to("x", url + "#{url.include?('?') ? '&' : '?'}cancel=true",
remote: true,
class: "close",
title: t(:close_form)
)
end
# Bcc: to dropbox address if the dropbox has been set up.
#----------------------------------------------------------------------------
def link_to_email(email, length = nil, &_block)
name = (length ? truncate(email, length: length) : email)
if Setting.email_dropbox && Setting.email_dropbox[:address].present?
mailto = "#{email}?bcc=#{Setting.email_dropbox[:address]}"
else
mailto = email
end
if block_given?
link_to("mailto:#{mailto}", title: email) do
yield
end
else
link_to(h(name), "mailto:#{mailto}", title: email)
end
end
#----------------------------------------------------------------------------
def jumpbox(current)
tabs = %i[campaigns accounts leads contacts opportunities]
current = tabs.first unless tabs.include?(current)
tabs.map do |tab|
link_to_function(t("tab_#{tab}"), "crm.jumper('#{tab}')", "html-data" => tab, class: (tab == current ? 'selected' : ''))
end.join(" | ").html_safe
end
#----------------------------------------------------------------------------
def styles_for(*models)
render partial: "shared/inline_styles", locals: { models: models }
end
#----------------------------------------------------------------------------
def hidden
{ style: "display:none;" }
end
def exposed
{ style: "display:block;" }
end
def invisible
{ style: "visibility:hidden;" }
end
def visible
{ style: "visibility:visible;" }
end
#----------------------------------------------------------------------------
def one_submit_only(_form = '')
{ onsubmit: "$('#'+this.id+' input[type=submit]').prop('disabled', true)".html_safe }
end
#----------------------------------------------------------------------------
def hidden_if(you_ask)
you_ask ? hidden : exposed
end
#----------------------------------------------------------------------------
def invisible_if(you_ask)
you_ask ? invisible : visible
end
#----------------------------------------------------------------------------
def confirm_delete(model, params = {})
question = %(#{t(:confirm_delete, model.class.to_s.downcase)})
yes = link_to(t(:yes_button), params[:url] || model, method: :delete)
no = link_to_function(t(:no_button), "$('#menu').html($('#confirm').html());")
text = "$('#confirm').html( $('#menu').html() );\n"
text << "$('#menu').html('#{question} #{yes} : #{no}');"
text.html_safe
end
#----------------------------------------------------------------------------
def spacer(width = 10)
image_tag "1x1.gif", width: width, height: 1, alt: nil
end
# Reresh sidebar using the action view within the current controller.
#----------------------------------------------------------------------------
def refresh_sidebar(action = nil, shake = nil)
refresh_sidebar_for(controller.controller_name, action, shake)
end
# Refresh sidebar using the action view within an arbitrary controller.
#----------------------------------------------------------------------------
def refresh_sidebar_for(view, action = nil, shake = nil)
text = ""
text << "$('#sidebar').html('#{j render(partial: 'layouts/sidebar', locals: { view: view, action: action })}');"
text << "$('##{j shake.to_s}').effect('shake', { duration:200, distance: 3 });" if shake
text.html_safe
end
# Display web presence mini-icons for Contact or Lead.
#----------------------------------------------------------------------------
def web_presence_icons(person)
%i[blog linkedin facebook twitter skype].map do |site|
url = person.send(site)
unless url.blank?
if site == :skype
url = "callto:" << url
else
url = "http://" << url unless url =~ /^https?:\/\//
end
link_to(image_tag("#{site}.gif", size: "15x15"), h(url), "data-popup": true, title: t(:open_in_window, h(url)))
end
end.compact.join("\n").html_safe
end
# Ajax helper to refresh current index page once the user selects an option.
#----------------------------------------------------------------------------
def redraw(option, value, url = send("redraw_#{controller.controller_name}_path"))
if value.is_a?(Array)
param = value.first
value = value.last
end
%{
if ($('##{option}').html() != '#{value}') {
$('##{option}').html('#{value}');
$('#loading').show();
$.post('#{url}', {#{option}: '#{param || value}'}, function () {
$('#loading').hide();
});
}
}
end
#----------------------------------------------------------------------------
def options_menu_item(option, key, url = send("redraw_#{controller.controller_name}_path"))
name = t("option_#{key}")
"{ name: \"#{name.titleize}\", on_select: function() {" +
%{
if ($('##{option}').html() != '#{name}') {
$('##{option}').html('#{name}');
$('#loading').show();
$.get('#{url}', {#{option}: '#{key}', query: $('#query').val()}, function () {
$('#loading').hide();
});
}
} + "}}"
end
# Ajax helper to pass browser timezone offset to the server.
#----------------------------------------------------------------------------
def get_browser_timezone_offset
unless session[:timezone_offset]
raw "$.get('#{timezone_path}', {offset: (new Date()).getTimezoneOffset()});"
end
end
# Entities can have associated avatars or gravatars. Only calls Gravatar
# in production env. Gravatar won't serve default images if they are not
# publically available: http://en.gravatar.com/site/implement/images
#----------------------------------------------------------------------------
def avatar_for(model, args = {})
args = { class: 'gravatar', size: :large }.merge(args)
if model.respond_to?(:avatar) && model.avatar.present?
image_tag(model.avatar.image.url(args.delete(:size)), args)
else
args = Avatar.size_from_style!(args) # convert size format :large => '75x75'
gravatar_image_tag(model.email, args)
end
end
# Returns default permissions intro.
#----------------------------------------------------------------------------
def get_default_permissions_intro(access, text)
case access
when "Private" then t(:permissions_intro_private, text)
when "Public" then t(:permissions_intro_public, text)
when "Shared" then t(:permissions_intro_shared, text)
end
end
# Render a text field that is part of compound address.
#----------------------------------------------------------------------------
def address_field(form, object, attribute, extra_styles)
hint = "#{t(attribute)}..."
if object.send(attribute).blank?
form.text_field(attribute,
style: "margin-top: 6px; #{extra_styles}",
placeholder: hint
)
else
form.text_field(attribute,
style: "margin-top: 6px; #{extra_styles}",
placeholder: hint
)
end
end
# Return true if:
# - it's an Ajax request made from the asset landing page (i.e. create opportunity
# from a contact landing page) OR
# - we're actually showing asset landing page.
#----------------------------------------------------------------------------
def shown_on_landing_page?
!!((request.xhr? && request.referer =~ %r{/\w+/\d+}) ||
(!request.xhr? && request.fullpath =~ %r{/\w+/\d+}))
end
# Helper to display links to supported data export formats.
#----------------------------------------------------------------------------
def links_to_export(action = :index)
token = current_user.single_access_token
url_params = { action: action }
url_params[:id] = params[:id] unless params[:id].blank?
url_params[:query] = params[:query] unless params[:query].blank?
url_params[:q] = params[:q] unless params[:q].blank?
url_params[:view] = @view unless @view.blank? # tasks
url_params[:id] = params[:id] unless params[:id].blank?
exports = %w[xls csv].map do |format|
link_to(format.upcase, url_params.merge(format: format), title: I18n.t(:"to_#{format}")) unless action.to_s == "show"
end
feeds = %w[rss atom].map do |format|
link_to(format.upcase, url_params.merge(format: format, authentication_credentials: token), title: I18n.t(:"to_#{format}"))
end
links = ['perm'].map do |format|
link_to(format.upcase, url_params, title: I18n.t(:"to_#{format}"))
end
(exports + feeds + links).compact.join(' | ')
end
def user_options
User.all.map { |u| [u.full_name, u.id] }
end
def group_options
Group.all.map { |g| [g.name, g.id] }
end
def list_of_entities
ENTITIES
end
def entity_filter_checkbox(name, value, count)
checked = (session["#{controller_name}_filter"].present? ? session["#{controller_name}_filter"].split(",").include?(value.to_s) : count.to_i > 0)
url = url_for(action: :filter)
onclick = %{
var query = $('#query').val(),
values = [];
$('input[name="#{h name}[]"]').filter(':checked').each(function () {
values.push(this.value);
});
$('#loading').show();
$.post('#{url}', {#{h name}: values.join(','), query: query}, function () {
$('#loading').hide();
});
}.html_safe
check_box_tag("#{name}[]", value, checked, id: value, onclick: onclick)
end
# Create a column in the 'asset_attributes' table.
# If a block is given, render it inside the td
#----------------------------------------------------------------------------
def col(title, value = nil, last = false, email = false, &_block)
last_class = (last ? 'last' : nil)
out = content_tag(:th, title, class: last_class)
if block_given?
out << content_tag(:td, class: last_class) do
yield
end
else
# Parse and format urls as links.
fmt_value = (value.to_s || "").gsub("\n", "
")
fmt_value = if email
link_to_email(fmt_value)
else
fmt_value.gsub(/((http|ftp|https):\/\/[\w\-_]+(\.[\w\-_]+)+([\w\-\.,@?^=%&:\/\+#]*[\w\-\@?^=%&\/\+#])?)/, "\\1")
end
out << content_tag(:td, fmt_value, class: last_class)
end
out
end
#----------------------------------------------------------------------------
# Combines the 'subtitle' helper with the small info text on the same line.
def section_title(id, hidden = true, text = nil, info_text = nil)
text = id.to_s.split("_").last.capitalize if text.nil?
content_tag("div", class: "subtitle show_attributes") do
content = link_to("#{hidden ? '►' : '▼'} #{sanitize text}".html_safe,
url_for(controller: :home, action: :toggle, id: id),
remote: true,
onclick: "crm.flip_subtitle(this)"
)
content << content_tag("small", info_text.to_s, class: "subtitle_inline_info", id: "#{id}_intro", style: hidden ? "" : "display:none;")
end
end
#----------------------------------------------------------------------------
# Return name of current view
def current_view_name
controller = params['controller']
action = params['action'] == 'show' ? 'show' : 'index' # create update redraw filter index actions all use index view
current_user.pref[:"#{controller}_#{action}_view"]
end
#----------------------------------------------------------------------------
# Get template in current context with current view name
def template_for_current_view
controller = params['controller']
action = params['action'] == 'show' ? 'show' : 'index' # create update redraw filter index actions all use index view
template = FatFreeCRM::ViewFactory.template_for_current_view(controller: controller, action: action, name: current_view_name)
template
end
#----------------------------------------------------------------------------
# Generate buttons for available views given the current context
def view_buttons
controller = params['controller']
action = params['action'] == 'show' ? 'show' : 'index' # create update redraw filter index actions all use index view
views = FatFreeCRM::ViewFactory.views_for(controller: controller, action: action)
return nil unless views.size > 1
lis = ''.html_safe
content_tag :ul, class: 'format-buttons' do
views.collect do |view|
classes = if (current_view_name == view.name) || (current_view_name.nil? && view.template.nil?) # nil indicates default template.
"#{h view.name}-button active"
else
"#{h view.name}-button"
end
lis << content_tag(:li) do
url = action == "index" ? send("redraw_#{controller}_path") : send("#{controller.singularize}_path")
link_to('#', title: t(view.name, default: h(view.title)), "data-view": h(view.name), "data-url": h(url), "data-context": action, class: classes) do
icon = view.icon || 'fa-bars'
content_tag(:i, nil, class: "fa #{h icon}")
end
end
end
lis
end
end
#----------------------------------------------------------------------------
# Generate the html for $.timeago function
# July 17, 2008
def timeago(time, options = {})
options[:class] ||= "timeago"
content_tag(:span, h(time.to_s), options.merge(title: time.getutc.iso8601)) if time
end
#----------------------------------------------------------------------------
# Translate List name to FontAwesome icon text
def get_icon(name)
case name
when "tasks" then "fa-check-square-o"
when "campaigns" then "fa-bar-chart-o"
when "leads" then "fa-tasks"
when "accounts" then "fa-users"
when "contacts" then "fa-user"
when "opportunities" then "fa-money"
when "team" then "fa-globe"
end
end
#----------------------------------------------------------------------------
# Ajaxification FTW!
# e.g. collection = Opportunity.my.scope
# options = { renderer: {...} , params: {...}
def paginate(options = {})
collection = options.delete(:collection)
options = { params: { action: 'index' } }.merge(options) if params['action'] == 'filter'
options = { renderer: RemoteLinkPaginationHelper::LinkRenderer }.merge(options)
will_paginate(collection, options)
end
end