====== ImgPaste Plugin ======

---- plugin ----
description: Add images and media via cut'n'paste
author     : Andreas Gohr 
email      : dokuwiki@cosmocode.de
type       : action
lastupdate : 2023-02-08
compatible : Hogfather, Igor, Jack Jackrum
depends    : 
conflicts  : 
similar    : dropfiles
tags       : paste, image, clipboard

downloadurl: https://github.com/cosmocode/dokuwiki-plugin-imgpaste/zipball/master
bugtracker : https://github.com/cosmocode/dokuwiki-plugin-imgpaste/issues
sourcerepo : https://github.com/cosmocode/dokuwiki-plugin-imgpaste/
donationurl: 

screenshot_img : 
----


This plugin allows to insert images and any other media files by simply pasting them into the editor. This can be raw image data in the clipboard (eg. when copying from an image editor) or files selected in your file explorer.


[[https://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ http://cosmocode.de/static/img/dokuwiki/dwplugins.png?recache|A CosmoCode Plugin}}]]


===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

=== Change Log ===

{{rss>https://github.com/cosmocode/dokuwiki-plugin-imgpaste/commits/master.atom date}}

===== Usage =====

Simply use ''CTRL-V'' or whatever pastes on your system while having some image data or file data in the clipboard and editing a page. The media will automatically be uploaded and the media syntax is inserted at your current cursor position.

===== Configuration and Settings =====

You can specify how image names are constructed. You should make sure the constructed name will be unique (by using the current time). In addition to [[phpfn>strftime]] wildcards, the following placeholders can be used:

^ Placeholder  ^ Description                                      ^
| @NS@         | Namespace of the currently edited page           |
| @ID@         | ID of the currently edited page                  |
| @USER@       | Username of the currently logged in user         |
| @PAGE@       | Name of currently edited page without namespace  |