X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=httemplate%2Fmisc%2Femail-customers.html;h=0c90b07e7e5e2afa4c862d18f04a8da77d863571;hb=a5148c7aabd33464432f9355d7cddf12c2147054;hp=de800ec6deb0e3adbc9c5176c7594275fc59dcb4;hpb=4aa7ddaf3e491d34a8caaa7869ccd83dc6d50d52;p=freeside.git diff --git a/httemplate/misc/email-customers.html b/httemplate/misc/email-customers.html index de800ec6d..0c90b07e7 100644 --- a/httemplate/misc/email-customers.html +++ b/httemplate/misc/email-customers.html @@ -1,12 +1,50 @@ -<% include('/elements/header.html', $title) %> +<%doc> -
+Allows emailing one or more customers, based on a search for customers. Search can +be specified either through cust_main fields as cgi params, or through a base64 encoded +frozen hash in the 'search' cgi param. Form allows selecting an existing msg_template, +or creating a custom message, and shows a preview of the message before sending. +If linked to as a popup, include the cgi parameter 'popup' for proper header handling. + +This may also be used as an element in other pages, enabling you to provide an +alternate initial form while using this for search freezing/thawing and +preview/send actions, with the following options: + +acl - the access right to use (defaults to 'Bulk send customer notices') + +form_action - the URL to submit the form to + +process_url - the URL for starting the JSRPC process + +title - the title of the page + +no_search_fields - arrayref of additional fields that are not search parameters + +alternate_form - subroutine that returns alternate html for the initial form, +replaces msgnum/from/subject/html_body/action inputs and submit button, +not used if an action is specified + +post_search_hook - sub hook for additional processing after search has been processed from cgi, +gets passed options 'conf' and 'search' (a reference to the unfrozen %search hash), +should be used to set msgnum or from/subject/html_body cgi params + + +% if ($popup) { +<& /elements/header-popup.html, $title &> +% } else { +<& /elements/header.html, $title &> +% } + + + %# Mixing search params with from address, subject, etc. required special-case %# handling of those, risked name conflicts, and caused massive problems with %# multi-valued search params. We are no longer in search context, so we %# pack the search into a Storable string for later use. + + % if ( $cgi->param('action') eq 'send' ) { @@ -15,8 +53,8 @@ <% include('/elements/progress-init.html', 'OneTrueForm', [ qw( search table from subject html_body text_body msgnum ) ], - 'process/email-customers.html', - { 'message' => "Notice sent" }, #would be nice to show #, but.. + $process_url, + $pdest, ) %> @@ -28,7 +66,7 @@ % if ( $cgi->param('action') ) { - +
% if ( $msg_template ) { @@ -54,8 +92,9 @@ %> + - + @@ -65,16 +104,34 @@ % ) % ); + - - +
 
Message (HTML display): Message (HTML display): <% $html_body %>
 
Message (Text display):
<% $text_body %>
Message (Text display): + + (view) + + +
-% if ( $cgi->param('action') eq 'preview' ) { +% if ( $cgi->param('action') eq 'preview' ) {