https://github.com/ub-mannheim/ape

ALMA Print Extension
https://github.com/ub-mannheim/ape

alma ape printing

Last synced: 2 months ago
JSON representation

ALMA Print Extension

• Host: GitHub
• URL: https://github.com/ub-mannheim/ape
• Owner: UB-Mannheim
• License: other
• Created: 2016-06-13T07:01:54.000Z (about 9 years ago)
• Default Branch: main
• Last Pushed: 2025-04-07T16:12:12.000Z (2 months ago)
• Last Synced: 2025-04-13T05:52:49.661Z (2 months ago)
• Topics: alma, ape, printing
• Language: PHP
• Size: 1.42 MB
• Stars: 9
• Watchers: 7
• Forks: 1
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: history/dummy
  • License: LICENSE.md

Awesome Lists containing this project

README

        
ALMA Print Extension (APE) - Easily Print Custom Letters & Notifications

========================================================================

Copyright (C) 2015-2022 Universitätsbibliothek Mannheim

Authors: see commit history

This is free software. You may use it under the terms of the

GNU General Public License (GPL). See [docs/gpl.txt](docs/gpl.txt) for details.

Parts of the software use different licenses which are listed

in file [LICENSE](LICENSE.md).

Summary

-------

Every email ALMA sends can be printed by a custom printer within your

local network. "Request Letters", "Resource Slips", "Reminders" or other emails

that are received by the server are directly forwarded to the APE script.

The APE script parses incoming HTML emails and converts them to PDF. The

generated PDF file can be printed out on any user-defined printer.

APE mainly supports two functions:

 * direct print (prints email immediately)

 * queue-controlled print (prints collected emails by cronjob)

APE has a simple and directory based file structure. Configuration changes can

easily be made by editing text files.

Additionally APE offers functions like caching emails in a temp directory.

It even has a print history, logging mechanisms and a print preview

for the best possible transparency.

Hard & Software requirements

----------------------------

APE was built on a Debian server system, but can be installed on any other

Windows or Linux system that is able to run an SMTP and web server as well.

The description beneath covers the software requirements of a Linux based

environment:

 * SMTP active and running

 * Apache2 or similar

 * PHP 7.4 or 8.0

 * PHP Mime Mail Parser

 * CUPS

 * WeasyPrint

Installation

------------

Mannheim University Library develops and installs APE as a web application

on a Linux server running Debian GNU Linux (Bullseye). Other hardware and software

combinations can also be used, but might require some smaller modifications.

See [INSTALL.md](INSTALL.md) for detailed information.

Bug reports

-----------

Please file your bug reports to https://github.com/UB-Mannheim/Ape/issues.

Make sure that you are using the latest version of the software

before sending a report.

Contributing

------------

Bug fixes, new functions, suggestions for new features and

other user feedback are appreciated.

The source code is available from https://github.com/UB-Mannheim/Ape.

Please prepare your code contributions also on GitHub.

Acknowledgments

---------------

This project uses other free software:

* [PHP Mime Mail Parser](https://github.com/php-mime-mail-parser/php-mime-mail-parser)

* [WeasyPrint](https://github.com/Kozea/WeasyPrint)