Paste reference

Paste reference 

Classification

paste reference

Version

main

Language

en

Keywords

paste reference backend content elements

Copyright

2025

Author

Ephraim Härer

License

This document is published under the Open Content License available from https://www.opencontent.org/opl.shtml

Rendered

Mon, 27 Oct 2025 14:33:19 +0000

The content of this document is related to TYPO3, a GNU/GPL CMS/Framework available from www.typo3.org.

Table of Contents

What does it do? 

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 this features but don't know that this aren't core features.

Basic features (extracted from EXT:gridelements)

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

Need Support? 

There are various ways to get support for EXT:paste_reference!

Stackoverflow 

Please use https://stackoverflow.com to get best support. Tags you should use are typo3 and tx-paste-reference, so your question will be visible at https://stackoverflow.com/questions/tagged/tx-paste-reference.

Slack 

You can use Slack to get support from other people and help about your questions!

The url is: https://typo3.slack.com/

Sponsoring 

If you need a feature which is not yet implemented, feel free to contact me anytime!

You can find my contact data on https://ephra.im/kontakt.

Private/Personal support 

If you need private or personal support, ask one of the developers for it.

Be aware that this support might not be free!

Help supporting further development 

This extension and manual has been created with extracting a lot of code and features from the extension gridelements.

If this extension helps you in anyway to achieve your requirements, please think about giving something back. Or you want to sponsor a feature to extend something that's already there? Then you can find my contact data here https://ephra.im/kontakt.

For editors 

This chapter describes how to use the extension from a user point of view.

How to start 

This walkthrough will help you to implement the extension paste_reference at your TYPO3 site. The installation is covered here.

Copy content from other page 

With the new button in page module it is possible to copy content from another page to the current page.

Paste reference into column 

Paste a copied content element like it's done normally in TYPO3 core.

You can select if you want to copy the element or if you want to insert a reference.

Installation 

The extension needs to be installed as any other extension of TYPO3 CMS:

  1. Switch to the module “Extension Manager”.

  2. Get the extension #. Use composer: Use composer require ehaerer/paste-reference.

    1. Get it from the Extension Manager: Press the “Retrieve/Update” button and search for the extension key paste_reference and import the extension from the repository.
    2. Get it from typo3.org: You can always get current version from https://extensions.typo3.org/extension/paste_reference/ by downloading either the t3x or zip version. Upload the file afterwards in the Extension Manager.
  3. The Extension Manager offers some basic configuration which is explained here.

Latest version from git 

You can get the latest version from git by using the git command:

git clone https://github.com/Kephson/paste_reference.git
Copied!

Updating 

If you update EXT:paste_reference to a newer version, please read this section carefully!

Versioning 

EXT:paste_reference uses a 3-number versioning scheme: <major>.<minor>.<patch>

  • Major: Major breaking changes
  • Minor: Minor breaking changes
  • Patch: No breaking changes

Before an update 

Before you start the update procedure, please read the changelog of all versions which have been released in the meantime! You can find those in the manual here.

Furthermore it is always a good idea to do updates on a dedicated test installation or at least create a database backup.

Configuration 

This chapter describes how to the extension can be configured

Extension Manager 

Some general settings can be configured in the Extension Configuration in the administration module. If you need to configure those, switch to the module "Admin tools" -> "Settings" -> "Extension Configuration", select the extension "paste_reference" and open it!

There are two settings:

Properties 

disableCopyFromPageButton 

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

For developers 

This chapter describes how you could contribute to the extension as a developer.

Contribute 

Contributions are essential for the success of open-source projects but certainly not limited to contribute code. A lot more can be done:

  • Improve documentation
  • Answer questions on stackoverflow.com

Contribution workflow 

Please create always an issue at https://github.com/Kephson/paste_reference/issues before starting with a change. This is essential helpful if you are unsure if your change will be accepted.

Get the latest version from git 

Fork the repository https://github.com/Kephson/paste_reference and provide a pull request with your change

Miscellaneous 

Misc

ChangeLog 

Please follow this link to know what has been done in which version.

List of versions 

4.0.3 - October 16, 2025 

Important changes 

All Changes 

This is a list of all changes in this release:

  • [BUGFIX] fixed basic problems with TYPO3 13.4

4.0.2 - November 28, 2024 

Important changes 

All Changes 

This is a list of all changes in this release:

  • [TASK] readded styling of referenced elements in backend

4.0.1 - November 18, 2024 

Important changes 

All Changes 

This is a list of all changes in this release:

  • [BUGFIX] fix eventHandler to show modal window for moving elements

4.0.0 - November 15, 2024 

Important changes 

All Changes 

This is a list of all changes in this release:

  • New release of this extension for TYPO3 version 13

3.0.5 - October 16, 2025 

Important changes 

All Changes 

This is a list of all changes in this release:

  • [BUGFIX] corrected path to translation file

3.0.4 - October 13, 2025 

Important changes 

All Changes 

This is a list of all changes in this release:

  • implemented pull request #83 with updates for TYPO3 12.4
  • added better compatibility with TYPO3 12.4

3.0.3 - November 28, 2024 

Important changes 

All Changes 

This is a list of all changes in this release:

  • [TASK] readded styling of referenced elements in backend

3.0.2 - November 18, 2024 

Important changes 

All Changes 

This is a list of all changes in this release:

  • [BUGFIX] fix eventHandler to show modal window for moving elements

3.0.1 - November 15, 2024 

Important changes 

All Changes 

This is a list of all changes in this release:

  • [CHG] included pull request from @zoranilic and fixed problems with translations when pasting a reference

3.0.0 - October 16, 2023 

Important changes 

All Changes 

This is a list of all changes in this release:

  • [CHG] updated all Classes and files to work with TYPO3 12
  • [CHG] moved/changed JavaScript files from RequireJS to ES6
  • initial release for TYPO3 >= 12.4

2.0.5 - September 3, 2023 

Important changes 

All Changes 

This is a list of all changes in this release:

  • [BUG] Inserting an Ref does not work #20, thanks to @boonkerz

2.0.4 - February 8, 2023 

Important changes 

All Changes 

This is a list of all changes in this release:

  • [FEATURE] added French translation files, thanks to @taieb123
  • [BUX] fixed problems with broken language when moving elements, thanks to @gamerxl
  • [BUG] fixed undefined header in modal, thanks to @taieb123

2.0.3 - 1st of February 2023 

Important changes 

All Changes 

This is a list of all changes in this release:

  • [BUG] fixed a problem with deprecated top.rawurlencode(), see issue #11, thanks to @taieb123

2.0.2 - 24 of October 2022 

Important changes 

All Changes 

This is a list of all changes in this release:

  • [BUG] fixed a problem with inserting elements from other pages, see issue #8, thanks to @tomashavner
  • [BUG] fixed problems drag and drop handling, see issue #8, thanks to @tomashavner
  • [FEATURE] replaced new JS window with backend Modal

2.0.1 - 12 of October 2022 

Important changes 

All Changes 

This is a list of all changes in this release:

  • fixed a problem with datahandler, see issue #6, thanks to @achimfritz
  • fixed a problem with shortcut preview renderer, see issue #5, thanks to @akiessling

2.0.0 - 31st August 2022 

Important changes 

All Changes 

This is a list of all changes in this release:

  • full update for TYPO3 11.5 only
  • thanks to @sbuerk and @nigelmann

1.0.0 - 19th February 2021 

Important changes 

All Changes 

This is a list of all changes in this release:

  • fixed backend JavaScripts for TYPO3 10
  • updated database handling for TYPO3 10
  • added documentation and updated readme
  • initial release of version 1.0 also in TER

0.1.0 - 17th February 2021 

Important changes 

All Changes 

This is a list of all changes in this release:

  • initial release for TYPO3 9.5 and 10.4
  • extracted most important functions from gridelements

Known problems 

The following issues are known problems. However those are either not fixable inside EXT:paste_reference or not too easy to solve!

Nothing reported at the moment 

There are no known issues or problems at the moment.

Documentation best practice 

Best practice for Documentation with rest

Examples 

Headline 2 

Headline 3 

Headline 4 

Headline 5 

https://wiki.typo3.org/ReST_Syntax

https://docs.typo3.org/

Properties 

Property Data type stdWrap Default
fobar Wrap yes <div>|</div>
subst\_elementUid boolean no 0

Property details 

This page

plugin.tx_extensionkey.wrapItemAndSub = Wrap

Wraps the whole item and any submenu concatenated to it.

subst_elementUid 

plugin.tx_extensionkey.subst_elementUid = boolean

text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text

API 

How to use the API...

$stuff = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(
	'\\Foo\\Bar\\Utility\\Stuff'
);
$stuff->do();
Copied!

or some other language:

$(document).ready(
	function () {
		doStuff();
	}
);
Copied!

Tables 

Header 1 Header 2 Header 3
body row 1 column 2 column 3
body row 3 Cells may span rows.
  • Cells
  • contain
  • blocks.
body row 4