library: barcode modes, patrons/lending, install-time shelves and item types
Quick Add: - barcode choices: automatic (zero-padded, >= 7 digits), scan a pre-printed sticker per item, or none for now; bulk 'give barcodes to items without one'; reserve a block of numbers and print the sheet ahead of time (link opens Koha's range printer prefilled) - default shelf saved on the server (shared by every device) - item types follow Koha; CSP allows cover redirects; aria attrs fixed Koha bootstrap: - default lending rule (3 weeks, 25 items, 3 renewals, no fines) - a fresh Koha refuses every checkout without one - automatic library-card numbers (start at 1000001), fines off - Koha's own auto-barcode off (one numbering scheme) - patron card template (Avery 5371) and layout with a scannable barcode - LIBRARY_CODE, SHELVES and ITEM_TYPES honoured at first install Why 7 digits: decoded printed sheets - 7-digit Code 39 read back 40/40, 6-digit all-numeric symbols were reinterpreted as Code 32 for ~1 in 10 values. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013wi3ZSot4XbUViwRFgLpRf
This commit is contained in:
Claude
+296
-62
@@ -13,6 +13,7 @@ import hmac
|
||||
import json
|
||||
import os
|
||||
import re
|
||||
import secrets
|
||||
import subprocess
|
||||
import tempfile
|
||||
import threading
|
||||
@@ -34,12 +35,11 @@ PORT = int(os.environ.get("PORT", "8082"))
|
||||
SOURCES = [s.strip() for s in os.environ.get(
|
||||
"QUICKADD_SOURCES", "z3950:lx2.loc.gov:210/LCDB,openlibrary").split(",") if s.strip()]
|
||||
Z3950_TIMEOUT = int(os.environ.get("Z3950_TIMEOUT", "12"))
|
||||
ITEM_TYPES = {"BOOK": "Book", "DVD": "Movie", "CD": "Music", "GAME": "Game", "OTHER": "Other"}
|
||||
DEFAULT_TYPES = {"BOOK": "Book", "DVD": "Movie", "CD": "Music", "GAME": "Game", "OTHER": "Other"}
|
||||
|
||||
NS = {"m": "http://www.loc.gov/MARC21/slim"}
|
||||
ET.register_namespace("", NS["m"])
|
||||
RECENT_FILE = os.path.join(DATA_DIR, "recent.json")
|
||||
LOCK = threading.Lock()
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- identifiers
|
||||
@@ -254,6 +254,30 @@ def koha(method, path, body=None, ctype="application/json", headers=None, query=
|
||||
raise KohaError(503, str(e))
|
||||
|
||||
|
||||
_TYPE_CACHE = {"at": 0.0, "value": dict(DEFAULT_TYPES)}
|
||||
|
||||
|
||||
def get_item_types():
|
||||
"""Item types as Koha has them (so types added at install or later in Koha
|
||||
appear here), cached for 60 s; falls back to the built-in five."""
|
||||
if time.time() - _TYPE_CACHE["at"] < 60:
|
||||
return _TYPE_CACHE["value"]
|
||||
try:
|
||||
vals = koha("GET", "/item_types", query={"_per_page": "100"}) or []
|
||||
found = {v["item_type_id"]: v.get("description") or v["item_type_id"] for v in vals}
|
||||
if found:
|
||||
_TYPE_CACHE["value"] = found
|
||||
_TYPE_CACHE["at"] = time.time()
|
||||
except KohaError:
|
||||
pass
|
||||
return _TYPE_CACHE["value"]
|
||||
|
||||
|
||||
def valid_type(code):
|
||||
types = get_item_types()
|
||||
return code if code in types else ("BOOK" if "BOOK" in types else next(iter(types)))
|
||||
|
||||
|
||||
_LOC_CACHE = {"at": 0.0, "value": []}
|
||||
|
||||
|
||||
@@ -293,41 +317,109 @@ def find_existing(code):
|
||||
return None
|
||||
|
||||
|
||||
def next_barcode():
|
||||
last = koha("GET", "/items", query={"_per_page": "1", "_order_by": "-item_id"})
|
||||
n = 0
|
||||
if last and re.fullmatch(r"\d+", last[0].get("external_id") or ""):
|
||||
n = int(last[0]["external_id"])
|
||||
return max(n, state_counter()) + 1
|
||||
# ------------------------------------------------------------------- settings
|
||||
SETTINGS_FILE = os.path.join(DATA_DIR, "settings.json")
|
||||
COUNTER_FILE = os.path.join(DATA_DIR, "counter.json")
|
||||
MIN_WIDTH, MAX_WIDTH = 7, 10 # 6 all-digit Code 39 symbols can be misread as Code 32 by some scanners
|
||||
DEFAULT_SETTINGS = {"barcode_mode": "auto", "width": MIN_WIDTH, "location": ""}
|
||||
BARCODE_MODES = ("auto", "scan", "none")
|
||||
LOCK = threading.RLock()
|
||||
|
||||
|
||||
def state_counter():
|
||||
def load_settings():
|
||||
s = dict(DEFAULT_SETTINGS)
|
||||
try:
|
||||
return int(open(os.path.join(DATA_DIR, "barcode")).read())
|
||||
s.update(json.load(open(SETTINGS_FILE)))
|
||||
except (OSError, ValueError):
|
||||
return 0
|
||||
|
||||
|
||||
def save_counter(n):
|
||||
try:
|
||||
os.makedirs(DATA_DIR, exist_ok=True)
|
||||
open(os.path.join(DATA_DIR, "barcode"), "w").write(str(n))
|
||||
except OSError:
|
||||
pass
|
||||
try:
|
||||
s["width"] = min(max(int(s["width"]), MIN_WIDTH), MAX_WIDTH)
|
||||
except (TypeError, ValueError):
|
||||
s["width"] = MIN_WIDTH
|
||||
return s
|
||||
|
||||
|
||||
def add_item(biblio_id, itype, callnum, location=None):
|
||||
"""Create an item with the next free barcode (retrying on collisions)."""
|
||||
start = next_barcode()
|
||||
for attempt in range(10):
|
||||
bc = str(start + attempt)
|
||||
def save_json(path, data):
|
||||
os.makedirs(DATA_DIR, exist_ok=True)
|
||||
tmp = path + ".tmp"
|
||||
with open(tmp, "w") as f:
|
||||
json.dump(data, f)
|
||||
os.replace(tmp, path)
|
||||
|
||||
|
||||
def clean_settings(payload, current):
|
||||
s = dict(current)
|
||||
if payload.get("barcode_mode") in BARCODE_MODES:
|
||||
s["barcode_mode"] = payload["barcode_mode"]
|
||||
if "width" in payload:
|
||||
try:
|
||||
item = koha("POST", "/biblios/%s/items" % biblio_id, {
|
||||
"external_id": bc, "item_type_id": itype, "home_library_id": LIBRARY,
|
||||
"holding_library_id": LIBRARY, "callnumber": callnum or None,
|
||||
"location": location})
|
||||
save_counter(start + attempt)
|
||||
return item
|
||||
s["width"] = min(max(int(payload["width"]), MIN_WIDTH), MAX_WIDTH)
|
||||
except (TypeError, ValueError):
|
||||
pass
|
||||
if "location" in payload:
|
||||
loc = payload["location"] or ""
|
||||
if loc == "" or valid_location(loc):
|
||||
s["location"] = loc
|
||||
return s
|
||||
|
||||
|
||||
# ------------------------------------------------------------------ barcodes
|
||||
# Fixed-width digits ("000042"): Koha's "Print barcode range" needs both ends
|
||||
# the same length, and it cannot take a prefix, so neither is offered.
|
||||
def fmt_barcode(n, s):
|
||||
return "%0*d" % (s["width"], n)
|
||||
|
||||
|
||||
def scan_max():
|
||||
"""Highest all-digit barcode already in Koha (paged; only when needed)."""
|
||||
mx, page = 0, 1
|
||||
while True:
|
||||
items = koha("GET", "/items", query={"_per_page": "100", "_page": str(page), "_order_by": "item_id"}) or []
|
||||
for it in items:
|
||||
bc = it.get("external_id") or ""
|
||||
if bc.isdigit():
|
||||
mx = max(mx, int(bc))
|
||||
if len(items) < 100:
|
||||
return mx
|
||||
page += 1
|
||||
|
||||
|
||||
def read_counter():
|
||||
try:
|
||||
return int(json.load(open(COUNTER_FILE))["n"])
|
||||
except (OSError, ValueError, KeyError, TypeError):
|
||||
n = scan_max() # first use (or lost state): start after what exists
|
||||
save_json(COUNTER_FILE, {"n": n})
|
||||
return n
|
||||
|
||||
|
||||
def peek_next():
|
||||
with LOCK:
|
||||
return read_counter() + 1
|
||||
|
||||
|
||||
def reserve(count):
|
||||
"""Reserve `count` consecutive numbers and return the first. Reserved
|
||||
numbers are never handed out again - a label may already be printed."""
|
||||
with LOCK:
|
||||
n = read_counter()
|
||||
save_json(COUNTER_FILE, {"n": n + count})
|
||||
return n + 1
|
||||
|
||||
|
||||
def add_item(biblio_id, itype, callnum, location, mode, scanned=None):
|
||||
s = load_settings()
|
||||
base = {"item_type_id": itype, "home_library_id": LIBRARY, "holding_library_id": LIBRARY,
|
||||
"callnumber": callnum or None, "location": location or None}
|
||||
path = "/biblios/%s/items" % biblio_id
|
||||
if mode == "none":
|
||||
return koha("POST", path, base)
|
||||
if mode == "scan":
|
||||
return koha("POST", path, dict(base, external_id=scanned))
|
||||
for _ in range(25):
|
||||
bc = fmt_barcode(reserve(1), s)
|
||||
try:
|
||||
return koha("POST", path, dict(base, external_id=bc))
|
||||
except KohaError as e:
|
||||
if e.status == 409 or "Duplicate" in e.body:
|
||||
continue
|
||||
@@ -348,8 +440,7 @@ def remember(entry):
|
||||
rec = load_recent()
|
||||
rec.insert(0, entry)
|
||||
try:
|
||||
os.makedirs(DATA_DIR, exist_ok=True)
|
||||
json.dump(rec[:300], open(RECENT_FILE, "w"))
|
||||
save_json(RECENT_FILE, rec[:300])
|
||||
except OSError:
|
||||
pass
|
||||
|
||||
@@ -358,7 +449,7 @@ def forget(item_id):
|
||||
with LOCK:
|
||||
rec = [r for r in load_recent() if r.get("item_id") != item_id]
|
||||
try:
|
||||
json.dump(rec, open(RECENT_FILE, "w"))
|
||||
save_json(RECENT_FILE, rec)
|
||||
except OSError:
|
||||
pass
|
||||
|
||||
@@ -379,36 +470,92 @@ def lookup(code):
|
||||
return None, None
|
||||
|
||||
|
||||
def op_add(payload):
|
||||
PENDING = {} # token -> (expires, plan): waiting for a scanned sticker
|
||||
PENDING_TTL = 1800
|
||||
|
||||
|
||||
def prune_pending():
|
||||
now = time.time()
|
||||
for k in [k for k, (exp, _) in PENDING.items() if exp < now]:
|
||||
del PENDING[k]
|
||||
|
||||
|
||||
def chosen_location(payload):
|
||||
"""The shelf for this add: an explicit choice wins, else the saved default."""
|
||||
if "location" in payload:
|
||||
return valid_location(payload.get("location"))
|
||||
return valid_location(load_settings().get("location"))
|
||||
|
||||
|
||||
def make_plan(payload):
|
||||
"""Look the code up. Returns ("done", http_status, body) or ("plan", plan)."""
|
||||
code = clean_code(payload.get("code"))
|
||||
itype = payload.get("type") if payload.get("type") in ITEM_TYPES else "BOOK"
|
||||
location = valid_location(payload.get("location"))
|
||||
itype = valid_type(payload.get("type"))
|
||||
if not code:
|
||||
return 400, {"status": "invalid", "message": "That doesn't look like an ISBN or barcode."}
|
||||
return "done", 400, {"status": "invalid", "message": "That doesn't look like an ISBN or barcode."}
|
||||
location = chosen_location(payload)
|
||||
with LOCK:
|
||||
existing = find_existing(code)
|
||||
if existing and not payload.get("copy"):
|
||||
return 200, dict(existing, status="duplicate", code=code)
|
||||
if existing: # add another copy of a known title
|
||||
with LOCK:
|
||||
item = add_item(existing["biblio_id"], itype, None, location)
|
||||
entry = entry_for(code, existing["title"], existing["author"], item, existing["biblio_id"], "extra copy")
|
||||
remember(entry)
|
||||
return 200, dict(entry, status="added")
|
||||
return "done", 200, dict(existing, status="duplicate", code=code)
|
||||
if existing:
|
||||
return "plan", {"code": code, "itype": itype, "location": location, "existing": existing,
|
||||
"xml": None, "title": existing["title"], "author": existing["author"],
|
||||
"callnum": None, "source": "extra copy"}
|
||||
xml, source = lookup(code)
|
||||
if not xml:
|
||||
return 200, {"status": "notfound", "code": code}
|
||||
return "done", 200, {"status": "notfound", "code": code}
|
||||
rec = parse_marc(xml)
|
||||
info = describe(rec)
|
||||
ensure_identifier(rec, code)
|
||||
set_item_type(rec, itype)
|
||||
return "plan", {"code": code, "itype": itype, "location": location, "existing": None,
|
||||
"xml": ET.tostring(rec, encoding="utf-8"), "title": info["title"], "author": info["author"],
|
||||
"callnum": call_number(rec, info["author"]), "source": source}
|
||||
|
||||
|
||||
def commit(plan, scanned=None):
|
||||
mode = load_settings()["barcode_mode"]
|
||||
with LOCK:
|
||||
bib = koha("POST", "/biblios", ET.tostring(rec, encoding="utf-8"), "application/marcxml+xml",
|
||||
{"x-confirm-not-duplicate": "1"})
|
||||
item = add_item(bib["id"], itype, call_number(rec, info["author"]), location)
|
||||
entry = entry_for(code, info["title"], info["author"], item, bib["id"], source)
|
||||
created = None
|
||||
if plan["existing"]:
|
||||
biblio_id = plan["existing"]["biblio_id"]
|
||||
else:
|
||||
bib = koha("POST", "/biblios", plan["xml"], "application/marcxml+xml", {"x-confirm-not-duplicate": "1"})
|
||||
biblio_id = created = bib["id"]
|
||||
try:
|
||||
item = add_item(biblio_id, plan["itype"], plan["callnum"], plan["location"], mode, scanned)
|
||||
except KohaError:
|
||||
if created: # don't leave an item-less record behind
|
||||
try:
|
||||
koha("DELETE", "/biblios/%s" % created)
|
||||
except KohaError:
|
||||
pass
|
||||
raise
|
||||
entry = entry_for(plan["code"], plan["title"], plan["author"], item, biblio_id, plan["source"])
|
||||
remember(entry)
|
||||
return 200, dict(entry, status="added")
|
||||
return dict(entry, status="added")
|
||||
|
||||
|
||||
def need_barcode(plan):
|
||||
token = secrets.token_urlsafe(12)
|
||||
prune_pending()
|
||||
PENDING[token] = (time.time() + PENDING_TTL, plan)
|
||||
return 200, {"status": "need_barcode", "token": token, "code": plan["code"],
|
||||
"title": plan["title"], "author": plan["author"]}
|
||||
|
||||
|
||||
def finish_or_ask(plan):
|
||||
if load_settings()["barcode_mode"] == "scan":
|
||||
return need_barcode(plan)
|
||||
return 200, commit(plan)
|
||||
|
||||
|
||||
def op_add(payload):
|
||||
kind, *rest = make_plan(payload)
|
||||
if kind == "done":
|
||||
return rest[0], rest[1]
|
||||
return finish_or_ask(rest[0])
|
||||
|
||||
|
||||
def op_manual(payload):
|
||||
@@ -416,18 +563,42 @@ def op_manual(payload):
|
||||
if not title:
|
||||
return 400, {"status": "invalid", "message": "A title is required."}
|
||||
code = clean_code(payload.get("code"))
|
||||
itype = payload.get("type") if payload.get("type") in ITEM_TYPES else "BOOK"
|
||||
location = valid_location(payload.get("location"))
|
||||
itype = valid_type(payload.get("type"))
|
||||
rec = manual_record(code, title[:240], (payload.get("author") or "").strip()[:120],
|
||||
(payload.get("year") or "").strip()[:8], (payload.get("publisher") or "").strip()[:120])
|
||||
set_item_type(rec, itype)
|
||||
with LOCK:
|
||||
bib = koha("POST", "/biblios", ET.tostring(rec, encoding="utf-8"), "application/marcxml+xml",
|
||||
{"x-confirm-not-duplicate": "1"})
|
||||
item = add_item(bib["id"], itype, None, location)
|
||||
entry = entry_for(code or "", title, payload.get("author") or "", item, bib["id"], "typed in")
|
||||
remember(entry)
|
||||
return 200, dict(entry, status="added")
|
||||
plan = {"code": code or "", "itype": itype, "location": chosen_location(payload), "existing": None,
|
||||
"xml": ET.tostring(rec, encoding="utf-8"), "title": title, "author": (payload.get("author") or "").strip(),
|
||||
"callnum": None, "source": "typed in"}
|
||||
return finish_or_ask(plan)
|
||||
|
||||
|
||||
STICKER_RE = re.compile(r"[A-Za-z0-9.$/+% -]{1,32}")
|
||||
|
||||
|
||||
def op_finish(payload):
|
||||
"""Second step of 'scan a pre-printed sticker' mode."""
|
||||
token = payload.get("token")
|
||||
barcode = (payload.get("barcode") or "").strip()
|
||||
prune_pending()
|
||||
entry = PENDING.get(token)
|
||||
if not entry:
|
||||
return 200, {"status": "error", "message": "That one timed out - scan the ISBN again."}
|
||||
if not STICKER_RE.fullmatch(barcode):
|
||||
return 200, {"status": "barcode_invalid", "token": token, "message": "That barcode has characters Koha can't use."}
|
||||
try:
|
||||
result = commit(entry[1], barcode)
|
||||
except KohaError as e:
|
||||
if e.status == 409 or "Duplicate" in e.body:
|
||||
return 200, {"status": "barcode_taken", "token": token, "barcode": barcode}
|
||||
raise
|
||||
PENDING.pop(token, None)
|
||||
return 200, result
|
||||
|
||||
|
||||
def op_cancel(payload):
|
||||
PENDING.pop(payload.get("token"), None)
|
||||
return 200, {"status": "cancelled"}
|
||||
|
||||
|
||||
def entry_for(code, title, author, item, biblio_id, source):
|
||||
@@ -454,6 +625,65 @@ def op_undo(payload):
|
||||
return 200, {"status": "undone"}
|
||||
|
||||
|
||||
# ----------------------------------------------------------- settings / tools
|
||||
def items_without_barcode():
|
||||
found, page = [], 1
|
||||
while len(found) < 5000:
|
||||
chunk = koha("GET", "/items", query={"q": json.dumps({"external_id": None}), "_per_page": "100",
|
||||
"_page": str(page), "_order_by": "item_id"}) or []
|
||||
found += chunk
|
||||
if len(chunk) < 100:
|
||||
break
|
||||
page += 1
|
||||
return found
|
||||
|
||||
|
||||
def settings_view():
|
||||
s = load_settings()
|
||||
try:
|
||||
missing = len(items_without_barcode())
|
||||
except KohaError:
|
||||
missing = None
|
||||
return {"settings": s, "next": fmt_barcode(peek_next(), s) if s["barcode_mode"] == "auto" else None,
|
||||
"without_barcode": missing, "locations": get_locations()}
|
||||
|
||||
|
||||
def op_settings(payload):
|
||||
with LOCK:
|
||||
s = clean_settings(payload, load_settings())
|
||||
save_json(SETTINGS_FILE, s)
|
||||
return 200, settings_view()
|
||||
|
||||
|
||||
def op_reserve(payload):
|
||||
try:
|
||||
count = int(payload.get("count"))
|
||||
except (TypeError, ValueError):
|
||||
count = 0
|
||||
if not 1 <= count <= 2000:
|
||||
return 400, {"status": "invalid", "message": "Choose between 1 and 2000."}
|
||||
s = load_settings()
|
||||
first = reserve(count)
|
||||
return 200, {"status": "reserved", "count": count, "first": fmt_barcode(first, s),
|
||||
"last": fmt_barcode(first + count - 1, s)}
|
||||
|
||||
|
||||
def op_assign(payload):
|
||||
"""Give a barcode to every item that has none."""
|
||||
s = load_settings()
|
||||
with LOCK:
|
||||
items = items_without_barcode()
|
||||
if not items:
|
||||
return 200, {"status": "assigned", "count": 0}
|
||||
first = reserve(len(items))
|
||||
for i, it in enumerate(items):
|
||||
koha("PUT", "/biblios/%s/items/%s" % (it["biblio_id"], it["item_id"]), {
|
||||
"external_id": fmt_barcode(first + i, s), "item_type_id": it["item_type_id"],
|
||||
"home_library_id": it["home_library_id"], "holding_library_id": it["holding_library_id"]})
|
||||
return 200, {"status": "assigned", "count": len(items), "first": fmt_barcode(first, s),
|
||||
"last": fmt_barcode(first + len(items) - 1, s)}
|
||||
|
||||
|
||||
# ----------------------------------------------------------------------- HTTP
|
||||
INDEX = open(os.path.join(os.path.dirname(os.path.abspath(__file__)), "index.html"), "rb").read()
|
||||
|
||||
@@ -474,7 +704,7 @@ class Handler(BaseHTTPRequestHandler):
|
||||
self.send_header("X-Content-Type-Options", "nosniff")
|
||||
self.send_header("Referrer-Policy", "no-referrer")
|
||||
self.send_header("Content-Security-Policy",
|
||||
"default-src 'self'; img-src 'self' https://covers.openlibrary.org data:; "
|
||||
"default-src 'self'; img-src 'self' https: data:; "
|
||||
"style-src 'self' 'unsafe-inline'; script-src 'self' 'unsafe-inline'")
|
||||
for k, v in (extra or {}).items():
|
||||
self.send_header(k, v)
|
||||
@@ -511,9 +741,11 @@ class Handler(BaseHTTPRequestHandler):
|
||||
if path == "/":
|
||||
return self._send(200, INDEX, "text/html; charset=utf-8")
|
||||
if path == "/api/state":
|
||||
return self._send(200, {"recent": load_recent()[:100], "types": ITEM_TYPES,
|
||||
"library": LIBRARY, "locations": get_locations(), "staff_port": STAFF_PORT, "opac_port": OPAC_PORT,
|
||||
return self._send(200, {"recent": load_recent()[:100], "types": get_item_types(),
|
||||
"library": LIBRARY, "locations": get_locations(), "settings": load_settings(), "staff_port": STAFF_PORT, "opac_port": OPAC_PORT,
|
||||
"sources": [s.split(":", 1)[0] if s.startswith("z3950") else s for s in SOURCES]})
|
||||
if path == "/api/settings":
|
||||
return self._send(200, settings_view())
|
||||
self._send(404, {"error": "not found"})
|
||||
|
||||
def do_POST(self):
|
||||
@@ -524,7 +756,9 @@ class Handler(BaseHTTPRequestHandler):
|
||||
if length > 20000:
|
||||
return self._send(413, {"error": "too large"})
|
||||
payload = json.loads(self.rfile.read(length) or b"{}")
|
||||
ops = {"/api/add": op_add, "/api/manual": op_manual, "/api/undo": op_undo}
|
||||
ops = {"/api/add": op_add, "/api/manual": op_manual, "/api/undo": op_undo,
|
||||
"/api/finish": op_finish, "/api/cancel": op_cancel, "/api/settings": op_settings,
|
||||
"/api/barcodes/reserve": op_reserve, "/api/barcodes/assign": op_assign}
|
||||
fn = ops.get(self.path)
|
||||
if not fn:
|
||||
return self._send(404, {"error": "not found"})
|
||||
|
||||
+129
-20
@@ -68,6 +68,16 @@
|
||||
ul.list .u { color: var(--muted); font-size: .9rem; }
|
||||
.labels { background: var(--card); border: 1px dashed var(--line); border-radius: 12px; padding: 12px; margin-top: 14px; }
|
||||
.small { color: var(--muted); font-size: .92rem; }
|
||||
details.settings { background: var(--card); border: 1px solid var(--line); border-radius: 12px; padding: 10px 14px; margin: 18px 0 0; }
|
||||
details.settings summary { cursor: pointer; font-weight: 700; }
|
||||
details.settings fieldset { border: 0; padding: 0; margin: 12px 0; }
|
||||
details.settings legend { font-weight: 700; padding: 0; margin-bottom: 4px; }
|
||||
details.settings label.opt { display: block; padding: 4px 0; }
|
||||
details.settings .tool { border-top: 1px solid var(--line); padding: 12px 0 4px; }
|
||||
details.settings select, details.settings input[type=number] { font: inherit; padding: 6px 8px; border: 1px solid var(--line);
|
||||
border-radius: 8px; background: var(--card); color: var(--ink); }
|
||||
details.settings input[type=number] { width: 6em; }
|
||||
.result-note { margin-top: 8px; padding: 8px 10px; border-radius: 8px; background: var(--ok-bg); border: 1px solid var(--ok); }
|
||||
.sr { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); }
|
||||
</style>
|
||||
</head>
|
||||
@@ -98,11 +108,39 @@
|
||||
<ul class="list" id="session"></ul>
|
||||
<div class="labels" id="labels" hidden>
|
||||
<strong id="range"></strong>
|
||||
<div class="small">Print spine labels and barcodes: open the label creator,
|
||||
choose <em>Print barcode range</em>, and enter these numbers.</div>
|
||||
<div class="actions"><a id="lnk-labels" href="#"><button type="button">Open label creator</button></a></div>
|
||||
<div class="small">Print barcode labels for these: the button opens the label printer with the range filled in
|
||||
(you may be asked to log in to the staff interface).</div>
|
||||
<div class="actions"><a id="lnk-labels" href="#" target="_blank" rel="noopener"><button type="button">Print labels</button></a></div>
|
||||
</div>
|
||||
|
||||
<details class="settings" id="settings">
|
||||
<summary>Barcodes and settings</summary>
|
||||
<fieldset>
|
||||
<legend>Barcodes on new items</legend>
|
||||
<label class="opt"><input type="radio" name="bcmode" value="auto"> Number them automatically</label>
|
||||
<label class="opt"><input type="radio" name="bcmode" value="scan"> I stick a pre-printed barcode on each one: ask me to scan it</label>
|
||||
<label class="opt"><input type="radio" name="bcmode" value="none"> No barcodes for now: I will add them later</label>
|
||||
<div class="small" style="margin-top:6px">
|
||||
Digits per barcode:
|
||||
<select id="width"></select>
|
||||
<span id="nextwrap"> Next barcode: <strong id="nextbc"></strong></span>
|
||||
</div>
|
||||
<div class="small">Same-length numbers are what Koha's label printer needs for a range, so numbers are zero-padded (0000042). Seven or more digits keeps scanners from misreading a short all-number barcode as the pharmacy "Code 32" format.</div>
|
||||
</fieldset>
|
||||
<div class="tool">
|
||||
<strong>Items without a barcode: <span id="missing">0</span></strong>
|
||||
<div class="actions"><button type="button" id="assign">Give them barcodes</button></div>
|
||||
</div>
|
||||
<div class="tool">
|
||||
<strong>Print a sheet of barcodes ahead of time</strong>
|
||||
<div class="small">Reserve a block of numbers, print the sheet, and stick the labels on whenever you like.</div>
|
||||
<div class="actions"><label for="reserve-count" class="sr">How many</label>
|
||||
<input type="number" id="reserve-count" min="1" max="2000" value="80">
|
||||
<button type="button" id="reserve">Reserve numbers</button></div>
|
||||
</div>
|
||||
<div id="tool-result" aria-live="polite"></div>
|
||||
</details>
|
||||
|
||||
<h2>Earlier</h2>
|
||||
<ul class="list" id="earlier"></ul>
|
||||
</main>
|
||||
@@ -110,7 +148,7 @@
|
||||
<script>
|
||||
(() => {
|
||||
const $ = id => document.getElementById(id);
|
||||
let types = {}, sessionItems = [], busy = false, lastAdded = null, shelf = localStorage.getItem('qa-shelf') || '', type = localStorage.getItem('qa-type') || 'BOOK';
|
||||
let types = {}, sessionItems = [], busy = false, lastAdded = null, shelf = '', awaiting = false, staffPort = '8081', settings = {}, type = localStorage.getItem('qa-type') || 'BOOK';
|
||||
|
||||
// --- small audible feedback so a stack of books can be scanned without looking
|
||||
let actx;
|
||||
@@ -128,7 +166,11 @@
|
||||
const SOUND = { added: [880], duplicate: [520, 520], notfound: [300], error: [220, 180] };
|
||||
|
||||
const el = (tag, props = {}, ...kids) => {
|
||||
const n = Object.assign(document.createElement(tag), props);
|
||||
const n = document.createElement(tag);
|
||||
for (const [k, v] of Object.entries(props)) {
|
||||
if (k.includes('-')) n.setAttribute(k, v); // aria-*, data-*: attributes, not JS properties
|
||||
else n[k] = v;
|
||||
}
|
||||
for (const k of kids) n.append(k);
|
||||
return n;
|
||||
};
|
||||
@@ -181,11 +223,14 @@
|
||||
function render() {
|
||||
$('session').replaceChildren(...sessionItems.map(e => rowFor(e, true)));
|
||||
$('count').textContent = sessionItems.length ? '(' + sessionItems.length + ')' : '';
|
||||
const nums = sessionItems.map(e => parseInt(e.barcode, 10)).filter(Number.isFinite);
|
||||
$('labels').hidden = nums.length === 0;
|
||||
if (nums.length) {
|
||||
const lo = Math.min(...nums), hi = Math.max(...nums);
|
||||
const bcs = sessionItems.map(e => e.barcode).filter(b => b && /^\d+$/.test(b));
|
||||
$('labels').hidden = bcs.length === 0;
|
||||
if (bcs.length) {
|
||||
const sameLen = bcs.every(b => b.length === bcs[0].length);
|
||||
const sorted = [...bcs].sort((a, b) => (a.length - b.length) || (a < b ? -1 : 1));
|
||||
const lo = sorted[0], hi = sorted[sorted.length - 1];
|
||||
$('range').textContent = lo === hi ? 'Barcode ' + lo : 'Barcodes ' + lo + ' to ' + hi;
|
||||
$('lnk-labels').href = sameLen ? printLink(lo, hi) : $('lnk-labels').href;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -193,19 +238,22 @@
|
||||
if (busy) return; busy = true;
|
||||
$('status').textContent = 'Looking up ' + code + '…';
|
||||
try {
|
||||
const r = await api('/api/add', Object.assign({ code, type, location: shelf }, opts));
|
||||
const r = await api('/api/add', Object.assign({ code, type }, opts));
|
||||
handle(r, code);
|
||||
} catch (e) {
|
||||
beep(SOUND.error); show('bad', el('div', { className: 'body' }, 'Could not reach the quick-add service.'));
|
||||
} finally { busy = false; $('code').focus(); }
|
||||
} finally { busy = false; if (!awaiting) $('code').focus(); }
|
||||
}
|
||||
|
||||
function handle(r, code) {
|
||||
$('status').textContent = '';
|
||||
if (r.status === 'added') {
|
||||
beep(SOUND.added); sessionItems.unshift(r); lastAdded = r.item_id; render();
|
||||
show('ok', cover(r.code), bookBody(r, [el('div', { className: 'meta' }, 'Added as barcode ',
|
||||
el('span', { className: 'badge' }, r.barcode), (r.source === 'extra copy' ? ' · another copy of a title you already have' : ' · from ' + r.source))]));
|
||||
awaiting = false; $('code').focus();
|
||||
show('ok', cover(r.code), bookBody(r, [el('div', { className: 'meta' },
|
||||
r.barcode ? 'Added as barcode ' : 'Added (no barcode yet)',
|
||||
r.barcode ? el('span', { className: 'badge' }, r.barcode) : '',
|
||||
(r.source === 'extra copy' ? ' · another copy of a title you already have' : ' · from ' + r.source))]));
|
||||
} else if (r.status === 'duplicate') {
|
||||
beep(SOUND.duplicate);
|
||||
const more = el('button', { className: 'primary', type: 'button' }, 'Add another copy');
|
||||
@@ -215,6 +263,8 @@
|
||||
show('warn', cover(code), bookBody(r, [el('div', { className: 'meta' },
|
||||
'You already have this (' + r.copies + (r.copies === 1 ? ' copy' : ' copies') + ').'),
|
||||
el('div', { className: 'actions' }, more, skip)]));
|
||||
} else if (r.status === 'need_barcode' || r.status === 'barcode_taken' || r.status === 'barcode_invalid') {
|
||||
stickerPrompt(r);
|
||||
} else if (r.status === 'notfound') {
|
||||
beep(SOUND.notfound); manualForm(code);
|
||||
} else {
|
||||
@@ -223,6 +273,67 @@
|
||||
}
|
||||
}
|
||||
|
||||
function stickerPrompt(r) {
|
||||
awaiting = true;
|
||||
const input = el('input', { placeholder: 'Scan the barcode sticker', autocomplete: 'off', 'aria-label': 'Barcode sticker', inputMode: 'text' });
|
||||
const form = el('form', { className: 'manual' });
|
||||
const cancel = el('button', { type: 'button' }, 'Cancel');
|
||||
cancel.onclick = async () => { await api('/api/cancel', { token: r.token }); awaiting = false;
|
||||
$('result').replaceChildren(); $('code').focus(); };
|
||||
form.append(input, el('div', { className: 'actions' }, el('button', { className: 'primary', type: 'submit' }, 'Add'), cancel));
|
||||
form.onsubmit = async ev => {
|
||||
ev.preventDefault();
|
||||
const bc = input.value.trim(); if (!bc) return;
|
||||
handle(await api('/api/finish', { token: r.token, barcode: bc }), r.code);
|
||||
};
|
||||
const msg = r.status === 'barcode_taken' ? 'Barcode ' + r.barcode + ' is already on another item. Scan a different sticker.'
|
||||
: r.status === 'barcode_invalid' ? (r.message || 'That barcode cannot be used.')
|
||||
: 'Now scan the barcode sticker you put on this one.';
|
||||
if (r.status !== 'need_barcode') beep(SOUND.duplicate);
|
||||
show('warn', bookBody(r, [el('div', { className: 'meta' }, msg), form]));
|
||||
input.focus();
|
||||
}
|
||||
|
||||
const printLink = (from, to) => 'http://' + location.hostname + ':' + staffPort +
|
||||
'/cgi-bin/koha/labels/label-print.pl?from=' + encodeURIComponent(from) + '&to=' + encodeURIComponent(to);
|
||||
|
||||
function rangeNote(text, from, to) {
|
||||
const note = el('div', { className: 'result-note' }, text + ' ');
|
||||
if (from) {
|
||||
const a = el('a', { href: printLink(from, to), target: '_blank', rel: 'noopener' }, 'Print these labels');
|
||||
note.append(a, el('div', { className: 'small' }, 'Pick a template and layout on the next screen (you will be asked to log in to the staff interface).'));
|
||||
}
|
||||
$('tool-result').replaceChildren(note);
|
||||
}
|
||||
|
||||
function applySettings(v) {
|
||||
settings = v.settings;
|
||||
document.querySelectorAll('input[name=bcmode]').forEach(i => { i.checked = i.value === settings.barcode_mode; });
|
||||
const w = $('width');
|
||||
if (!w.options.length) for (let n = 7; n <= 10; n++) w.append(el('option', { value: n }, String(n)));
|
||||
w.value = settings.width;
|
||||
$('nextwrap').hidden = settings.barcode_mode !== 'auto';
|
||||
$('nextbc').textContent = v.next || '';
|
||||
$('missing').textContent = v.without_barcode == null ? '?' : v.without_barcode;
|
||||
$('assign').disabled = !v.without_barcode;
|
||||
}
|
||||
|
||||
async function saveSettings(patch) { applySettings(await api('/api/settings', patch)); }
|
||||
|
||||
document.querySelectorAll('input[name=bcmode]').forEach(i => i.onchange = () => saveSettings({ barcode_mode: i.value }));
|
||||
$('width').onchange = () => saveSettings({ width: parseInt($('width').value, 10) });
|
||||
$('assign').onclick = async () => {
|
||||
$('assign').disabled = true;
|
||||
const r = await api('/api/barcodes/assign', {});
|
||||
rangeNote(r.count ? r.count + ' item(s) now have barcodes ' + r.first + ' to ' + r.last + '.' : 'Every item already has a barcode.', r.first, r.last);
|
||||
saveSettings({});
|
||||
};
|
||||
$('reserve').onclick = async () => {
|
||||
const r = await api('/api/barcodes/reserve', { count: parseInt($('reserve-count').value, 10) });
|
||||
if (r.status === 'reserved') { rangeNote('Reserved ' + r.first + ' to ' + r.last + ' (' + r.count + ' labels).', r.first, r.last); saveSettings({}); }
|
||||
else rangeNote(r.message || 'Could not reserve that many.');
|
||||
};
|
||||
|
||||
function manualForm(code) {
|
||||
const f = el('form', { className: 'manual' });
|
||||
const field = (name, ph, req) => el('input', { name, placeholder: ph, required: !!req, 'aria-label': ph });
|
||||
@@ -234,7 +345,7 @@
|
||||
f.onsubmit = async ev => {
|
||||
ev.preventDefault();
|
||||
const d = Object.fromEntries(new FormData(f));
|
||||
handle(await api('/api/manual', Object.assign(d, { code, type, location: shelf })), code);
|
||||
handle(await api('/api/manual', Object.assign(d, { code, type })), code);
|
||||
};
|
||||
show('warn', el('div', { className: 'body' }, el('div', { className: 'title' }, 'Not found: ' + code),
|
||||
el('div', { className: 'meta' }, 'None of the catalogues knew this one. Type the details and it is added anyway.'), f));
|
||||
@@ -258,19 +369,17 @@
|
||||
(async () => {
|
||||
const s = await api('/api/state');
|
||||
types = s.types; if (!types[type]) type = 'BOOK'; typeButtons();
|
||||
staffPort = s.staff_port; settings = s.settings || {}; shelf = settings.location || '';
|
||||
if (s.locations && s.locations.length) {
|
||||
const sel = $('shelf');
|
||||
sel.replaceChildren(el('option', { value: '' }, '(not set)'),
|
||||
sel.replaceChildren(el('option', { value: '' }, '(not set / all in one place)'),
|
||||
...s.locations.map(l => el('option', { value: l.value }, l.label)));
|
||||
if (![...sel.options].some(o => o.value === shelf)) shelf = '';
|
||||
sel.value = shelf;
|
||||
sel.onchange = () => { shelf = sel.value; localStorage.setItem('qa-shelf', shelf); $('code').focus(); };
|
||||
sel.onchange = () => { shelf = sel.value; saveSettings({ location: shelf }); $('code').focus(); };
|
||||
$('shelfbox').hidden = false;
|
||||
}
|
||||
const host = location.hostname;
|
||||
$('lnk-opac').href = 'http://' + host + ':' + s.opac_port + '/';
|
||||
$('lnk-staff').href = 'http://' + host + ':' + s.staff_port + '/';
|
||||
$('lnk-labels').href = 'http://' + host + ':' + s.staff_port + '/cgi-bin/koha/labels/label-edit-range.pl';
|
||||
api('/api/settings').then(applySettings);
|
||||
$('earlier').replaceChildren(...s.recent.slice(0, 25).map(e => rowFor(e, false)));
|
||||
$('code').focus();
|
||||
})();
|
||||
|
||||
Reference in New Issue
Block a user