An open API service indexing awesome lists of open source software.

https://github.com/in2code-de/publications

Follower of EXT:bib to show publications in TYPO3. Im- and export of bibtext and xml files.
https://github.com/in2code-de/publications

typo3 typo3-extension

Last synced: 8 months ago
JSON representation

Follower of EXT:bib to show publications in TYPO3. Im- and export of bibtext and xml files.

Awesome Lists containing this project

README

          

# publications is an TYPO3 extension to list academic publications

Inspired by the TYPO3 **bib** extension

## Introduction

Target group of this extension are universities and colleges:
Show academic publications in a listview with some filter possibilities in the plugin and in frontend.
Im- and export BibTeX or XML files (Import via Backend Module, Export in Frontend) to list publications.
Easily extend this extension with own importers or own citestyles.

At the moment we support a default and the IEEE citestyle.

## Screenshots

Example list view:
![Example listview](Documentation/Images/screenshot_frontend_listview.png "Listview")

Plugin:
![Plugin](Documentation/Images/screenshot_backend_plugin.png "Plugin")

Import module:
![Module](Documentation/Images/screenshot_backend_module.png "Module")

## Technical requirements

This extension needs *TYPO3 13*
At the moment it's not possible to use publications without **composer mode**! Classic mode is not supported.

## Installation

* Install the extension via composer: `composer require in2code/publications`
* Clean caches
* Add the static TypoScript of the extension to your installation root template
* Add some publication and author records to a sysfolder
* Add the publication plugin to a default page
* That's it

## Extending publications

* Look at the [importer documentation](Documentation/Importer.md) to see how you can add own importers
* Look at the [citestyle documentation](Documentation/Citestyles.md) to see how you can add your own cite styles

## Migration from bib

If you want to migrate records from extension bib to publications, there is a Command Controller for doing this

```
./vendor/bin/typo3cms publications:migrate
```

**Note:** If you want to delete all publications records before (to minimize uid conflicts), you can use

```
# Delete all records (truncate all tables)
./vendor/bin/typo3cms publications:clean 0

# Delete all records on page with uid 123
./vendor/bin/typo3cms publications:clean 123
```

## Contribution with ddev

This repository provides a [DDEV]()-backed development environment. If DDEV is installed, simply run the following
commands to quickly set up a local environment with example usages:

* `ddev start`
* `ddev initialize`

### Requirements

1. Install ddev, see: https://ddev.readthedocs.io/en/stable/#installation
2. Install git-lfs, see: https://git-lfs.github.com/

### Installation

1. Clone this repository
2. Run `ddev start`
3. Run `ddev initialize` to setup configurations and test database

## Branchinfo

* master Branch - Next Major Version

### Check and fix code style

This project uses php-cs-fixer to check for PHP coding standards.
For a list of the used rules see: `.project/tests/.php-cs-fixer.php`.

Run the PHP code style test (local):
```
ddev ssh
composer test:php:cs
```

Automatic fix of code style violations:

This command tries to fix code violations automatically.
This works for the most violations (indent, spaces etc.).
If an automatic fix is not possible the fixes must be done manually.
```
ddev ssh
./.build/bin/php-cs-fixer fix --config=.project/tests/.php-cs-fixer.php --diff
```
## Early Access Programm for TYPO3 14 support

:information_source: **TYPO3 14 compatibility**
> See [EAP page (DE)](https://www.in2code.de/agentur/typo3-extensions/early-access-programm/) or
> [EAP page (EN)](https://www.in2code.de/en/agency/typo3-extensions/early-access-program/) for more information how
> to get access to a TYPO3 14 version

## Changelog

| Version | Date | State | Description |
|---------|------------|---------|-----------------------------------------------------------------------------------------------------------------------------------|
| 13.0.0 | 2025-08-08 | Feature | Support TYPO3 13 |
| 6.2.1 | 2025-04-16 | Bugfix | Fix undefined array key exception |
| 6.2.0 | 2025-02-20 | Feature | Filter for "reviewed", and abbreviated journal title |
| 6.1.0 | 2024-04-08 | Feature | Add improved search template and functionality |
| 6.0.2 | 2024-01-22 | Task | First public release of TYPO3 V12 compatible release |
| 6.0.0 | 2023-06-28 | Task | Support TYPO3 12 |
| 5.4.0 | 2023-04-08 | Bugfix | Add missing use for ImportController |
| 5.3.1 | 2023-02-24 | Bugfix | Add missing use for ImportController |
| 5.3.0 | 2023-02-24 | Feature | Additional import option "language behaviour". Allows to specify the target langauge of imports |
| 5.2.0 | 2022-12-12 | Feature | French umlaute |
| 5.1.0 | 2022-10-13 | Feature | Rework highlighting of authors |
| 5.0.2 | 2022-09-28 | Bugfix | Fix author highlighting, fix internal author linking |
| 5.0.1 | 2022-09-21 | Bugfix | Fix bibtex and xml export |
| 5.0.0 | 2022-09-20 | Feature | Backend improvements, bugfixes |
| 4.1.0 | 2022-09-08 | Bugfix | Fix TCA link wizard, because it was deprecated
|
| 4.0.1 | 2022-06-20 | Bugfix | Fix document type frontend filter if no filter is set |
| 4.0.0 | 2022-05-25 | Feature | Drop support for TYPO3 9 and 10, provide ddev based development environment,
add github actions for testing and TER release. |
| 3.0.0 | 2022-02-16 | Feature | Highlighted Authors, Link names, Citestyles, Author model added. Support pmid field in migration. |
| 2.3.0 | 2021-03-19 | Feature | Special character support for bib import, Fix generated icon tags |
| 2.2.0 | 2021-03-17 | Task | Add auto deployment to TER, Add extension key in composer.json |
| 2.1.0 | 2020-12-03 | Feature | Allow backend search for publications and authors |
| 2.0.0 | 2020-11-25 | Task | Support TYPO3 10 and drop support for 8, Space in IEEE between month and year now |
| 1.17.0 | 2020-05-28 | Feature | Add new citestyle APA |
| 1.16.0 | 2020-04-14 | Feature | Add system fields (hidden, sys_language_uid, starttime, endtime) |
| 1.15.0 | 2020-04-09 | Feature | Allow multiple record storage pages, add recursive storage page loading |
| 1.14.0 | 2020-03-12 | Feature | Use sections for data elements, Translate labels in standard citestyles |
| 1.13.2 | 2019-03-11 | Bugfix | Make composer.json compatible to composer 2.0 |
| 1.13.1 | 2019-03-11 | Bugfix | Remove wrong whitespaces, fix translation keys |
| 1.13.0 | 2019-12-11 | Feature | Improve layout and add missing colons, render partial "LinkBlock" only if needed |
| 1.12.0 | 2019-11-29 | Feature | Make enumeration toggleble, bugfix with SQL mode strict and importers |
| 1.11.0 | 2019-11-19 | Feature | Make filter toggleble |
| 1.10.0 | 2019-11-19 | Feature | Add additional section to some bibtypes |
| 1.9.1 | 2019-11-19 | Bugfix | Fix orderings bug |
| 1.9.0 | 2019-10-29 | Feature | Add localization for abstract label |
| 1.8.0 | 2019-10-19 | Feature | Adjust styling |
| 1.7.0 | 2019-10-18 | Feature | Add missing label |
| 1.6.0 | 2019-10-18 | Feature | Add abstract field in FE output |
| 1.5.0 | 2019-10-08 | Feature | Add a sorting by date (if no date, take 1.1.currentyear) |
| 1.4.0 | 2019-10-07 | Feature | Add new cite style (IEEE with abstract) |
| 1.3.1 | 2019-09-10 | Bugfix | Don't respect storage page in all repository functions |
| 1.3.0 | 2019-09-09 | Feature | Allow multiple authors for filtering be+fe, Prefilter with extern/intern in plugin |
| 1.2.0 | 2019-09-02 | Task | Allow table wide exclude field definition, small change for title and bibtype tca |
| 1.1.0 | 2019-08-29 | Task | Fix issue with staticfilecache, use individual filter cookie per ce, year bugfix |
| 1.0.1 | 2019-08-27 | Bugfix | Fix some small typos |
| 1.0.0 | 2019-08-27 | Task | First stable release |
| 0.4.0 | 2019-08-26 | Task | 4. prerelease with documentation |
| 0.3.0 | 2019-08-26 | Task | 3. prerelease with a finalized citestyles |
| 0.2.0 | 2019-08-26 | Task | 2. prerelease with a basic IEEE citestyle |
| 0.1.0 | 2019-08-21 | Task | First prerelease with a default citestyle only |

## Patrons

* University of Ulm as the main sponsor of this extension
* in2code GmbH as the development partner of this extension

## Credits

The icons
* docx icon was made by Freepik
* pdf icon was made by Smashicons