New plugin: print part labels on a Brother QL printer

Print label in the top-right actions of issues, estimates and invoices
prints the customer's last name and the PO number (W/E/I + number) in big
bold letters on a 62mm continuous roll, with a preview of the label and
its status until it's printed. A print agent on the printer's network
(redmine_qbo_label_agent) asks Redmine for labels every couple of seconds
with its printer's token, so labels print from anywhere.

Administration » Label printers: printers, agent tokens and status,
recent labels. Settings: label lengths, capitals, poll interval, how long
a label waits for an offline agent, and logging the agents' requests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
rickyandClaude Opus 5.5 committed 2026-11-16 08:42:16 -05:00
commit 3e29f14f76
41 files changed
+2194

No files matched your search

+69
View File
@@ -0,0 +1,69 @@
<%# The Print label dialog: the label's lines (filled from the issue, estimate or invoice), a preview drawn
the way the print agent draws it (assets/javascripts/qbo_labels.js), copies and printer %>
<div id="qbo-label-dialog"
data-max-length-mm="<%= RedmineQboLabels::Settings.max_length_mm %>"
data-min-length-mm="<%= RedmineQboLabels::Settings.min_length_mm %>"
data-uppercase="<%= RedmineQboLabels::Settings.uppercase? %>"
data-text-printing="<%= l(:text_qbo_labels_printing) %>"
data-text-waiting="<%= l(:text_qbo_labels_waiting) %>"
data-text-offline="<%= l(:text_qbo_labels_offline) %>"
data-text-lost="<%= l(:text_qbo_labels_lost_contact) %>">
<% if @printers.empty? %>
<p class="nodata"><%= l(:text_qbo_labels_no_printers) %></p>
<% else %>
<%= form_tag label_jobs_path, remote: true, id: 'qbo-label-form' do %>
<%= hidden_field_tag :source_type, @source.type %>
<%= hidden_field_tag :source_id, @source.id %>
<% if @job&.errors&.any? %>
<div id="errorExplanation"><ul><% @job.errors.full_messages.each do |message| %><li><%= message %></li><% end %></ul></div>
<% end %>
<div class="qbo-label-preview-wrap">
<canvas class="qbo-label-preview" width="1" height="1" aria-label="<%= l(:label_qbo_labels_preview) %>"></canvas>
<div class="qbo-label-size"></div>
</div>
<div class="tabular">
<p>
<label for="qbo_label_line_0"><%= l(:field_qbo_labels_name) %></label>
<%= text_field_tag 'lines[]', @lines[0], id: 'qbo_label_line_0', class: 'qbo-label-line',
maxlength: LabelJob::MAX_LINE_LENGTH, autocomplete: 'off' %>
</p>
<p>
<label for="qbo_label_line_1"><%= l(:field_qbo_labels_po_number) %></label>
<%= text_field_tag 'lines[]', @lines[1], id: 'qbo_label_line_1', class: 'qbo-label-line',
maxlength: LabelJob::MAX_LINE_LENGTH, autocomplete: 'off' %>
</p>
<p>
<label for="qbo_label_copies"><%= l(:field_qbo_labels_copies) %></label>
<%= number_field_tag :copies, @copies, id: 'qbo_label_copies', min: 1, max: LabelJob::MAX_COPIES,
class: 'qbo-label-copies' %>
</p>
<% if @printers.size > 1 %>
<p>
<label for="qbo_label_printer"><%= l(:field_qbo_labels_printer) %></label>
<%= select_tag :printer_id,
options_for_select(@printers.map { |p| ["#{p.name}#{" (#{l(:label_qbo_labels_offline)})" unless p.online?}", p.id] },
params[:printer_id] || @printers.find(&:online?)&.id),
id: 'qbo_label_printer' %>
</p>
<% elsif !@printers.first.online? %>
<p class="qbo-label-warning"><%= l(:text_qbo_labels_printer_offline, name: @printers.first.name) %></p>
<% end %>
</div>
<p class="buttons">
<%= submit_tag l(:button_qbo_labels_print), class: 'qbo-label-submit', data: { disable_with: l(:button_qbo_labels_print) } %>
<%= link_to_function l(:button_cancel), 'hideModal(this);' %>
</p>
<% end %>
<div class="qbo-label-status" hidden>
<p class="qbo-label-status-text"></p>
<p class="buttons">
<%= button_tag l(:button_qbo_labels_print_another), type: 'button', onclick: 'QboLabels.again();', class: 'qbo-label-again' %>
<%= button_tag l(:button_close), type: 'button', onclick: 'hideModal(this);' %>
</p>
</div>
<% end %>
</div>
+7
View File
@@ -0,0 +1,7 @@
<% if @job.persisted? %>
QboLabels.follow(<%= raw({ url: label_job_path(@job), printer: @job.label_printer.name,
printer_online: @job.label_printer.online? }.to_json) %>);
<% else %>
$('#ajax-modal').html('<%= escape_javascript(render partial: 'label_jobs/dialog') %>');
QboLabels.initDialog();
<% end %>
+3
View File
@@ -0,0 +1,3 @@
$('#ajax-modal').html('<%= escape_javascript(render partial: 'label_jobs/dialog') %>');
showModal('ajax-modal', '480px', '<%= escape_javascript(l(:label_qbo_labels_print_title)) %>');
QboLabels.initDialog();