This extension brings the extracted functions from gridelements to copy and paste content elements also as reference and not only as copy. A lot of TYPO3 users love these features but don't know that this aren't core features.

• Copy content elements and paste as reference (also in context menu with right click)
• Copy content elements from other pages in page module
• Full documentation in TYPO3 TER

The recommended way to install the extension is using Composer.

Run the following command within your Composer based TYPO3 project:

composer require ehaerer/paste-reference

Download and install the extension with the extension manager module.

1. Just install the extension and you are done

Please report issue directly in the issue tracker in the Github repository.

• disableCopyFromPageButton - You can disable the "copy from page button" in the page module if you don't need it.

Please look into the official extension documentation in changelog chapter.

Paste reference uses semantic versioning, which means, that

• bugfix updates (e.g. 1.0.0 => 1.0.1) just includes small bugfixes or security relevant stuff without breaking changes,
• minor updates (e.g. 1.0.0 => 1.1.0) includes new features and smaller tasks without breaking changes,
• and major updates (e.g. 1.0.0 => 2.0.0) breaking changes wich can be refactorings, features or bugfixes.

Pull Requests are gladly welcome! Nevertheless please don't forget to add an issue and connect it to your pull requests. This is very helpful to understand what kind of issue the PR is going to solve.

Bugfixes: Please describe what kind of bug your fix solve and give us feedback how to reproduce the issue. We're going to accept only bugfixes if we can reproduce the issue.

Features: Not every feature is relevant for the bulk of paste_reference users. In addition: We don't want to make paste_reference even more complicated in usability for an edge case feature. It helps to have a discussion about a new feature before you open a pull request.

This repository contains a so-called Extension for the TYPO3 CMS which cannot be used on its own but has been prepared to install required dependency to provide a TYPO3 v12 composer based installation within the untracked .Build/ folder with .Build/public/ being the doc-root to point a web-server on.

For simpler onboarding a generic ddev project configuration is included to quickstart a local TYPO3 v12 instance in a predefined environment along with data set. See 5.2 for how to use ddev.

Please ensure to have the pre-requisit ddev and docker/colima/... installed and working to follow this section.

ddev start \
  && ddev composer install \
  && ddev restart \
  && ddev typo3 setup \
        --driver=mysqli \
        --host=db \
        --port=3306 \
        --dbname=db \
        --username=db \
        --password=db \
        --admin-username=john-doe \
        --admin-user-password='John-Doe-1701D.' \
        --admin-email="[email protected]" \
        --project-name='ext-paste-reference' \
        --no-interaction \
        --server-type=apache \
        --force \
  && ddev restart \
  && ddev typo3 cache:warmup \
  && ddev typo3 styleguide:generate --create all \
  && ddev typo3 cache:warmup \
  && ddev launch /typo3/

which creates a instance with two different hidden page trees and a admin user without asking for it. Adjust the --admin-* arguments to match your needs.

First startup and composer package installation

ddev start \
  && ddev composer install \
  && ddev restart

Setup TYPO3 using typo3 setup command

Note that the following command is interactive and asks for admin user credential, name and email. Ensure to remember the values you enter here for later login into the TYPO3 backend.

ddev typo3 setup \
    --driver=mysqli \
    --host=db \
    --port=3306 \
    --dbname=db \
    --username=db \
    --password=db \
    --server-type=apache \
    --force \
  && ddev restart

Use EXT:styleguide to create page trees

ddev typo3 styleguide:generate --create all \
  && ddev typo3 cache:warmup

Launch the backend login form

ddev launch /typo3/

Simply stop ddev instance

ddev stop

Completely remove ddev instance

ddev stop -ROU

To render the documentation, the TYPO3 Documentation render-guides image can be used, which is included in the Build/Scripts/runTests.sh dispatcher script.

Render documentation

Build/Scripts/runTests.sh -s renderDocumentation

Open rendered documentation (Linux>

Build/Scripts/runTests.sh -s renderDocumentation
xdg-open "Documentation-GENERATED-temp/Index.html"

Open rendered documentation (MacOS)

Build/Scripts/runTests.sh -s renderDocumentation
open "Documentation-GENERATED-temp/Index.html"

Open rendered documentation (Windows)

Build/Scripts/runTests.sh -s renderDocumentation
start "Documentation-GENERATED-temp/Index.html"