Difference between revisions of "Archive:Extension/PasteImage"

<bs:bookshelf src="Book:User manual" />
        
        
        
        __TOC__
        
        
        
        ==What is PasteImage?==
        
        
        
        '''PasteImage''' allows users to include images in an article, either via Drag&Drop, or by copying it from the clipboard.
        
        
        
        No complicated code necessary.
        
        
        
        ==Where to find PasteImage?==
        
        
        
        PasteImage is integrated in the edit mode of the wiki. Every time an image is pasted or dropped into one of the two editors, PasteImage is automatically loaded and provides you a special window to enter further data.
        
        
        
        ==How to use PasteImage? (Step-by-step)==
        
        
        
        '''Note:''' Please see the entry ''Technical background'' for system requirements and compatibility!
        
        
        
        '''Option 1: Via Drag & drop'''
        
        
        
        : '''Step 1:''' Open the respective wiki article in edit mode. 
        
        : '''Step 2:''' Open your Explorer and choose the picture you want to add to your article.
        
        : '''Step 3:''' Drag and drop the picture into your editor window. A separate window will pop up where you can enter additional information and credentials.
        
        
        
        ::: [[File:DrgImg1.jpg|500x388px]]
        
        
        
        
        
        ::: [[File:DrgImg2.jpg|500x270px]]
        
        
        
        
        
        ::: [[File:DrgImg3.jpg|500x271px]]
        
        
        
        
        
        ::: [[File:DrgImg4.jpg|500x271px]]
        
        
        
        You should get:
        
        
        
        ::: [[File:DrgImg5.jpg|500x276px]]
        
        
        
        '''Option 2: Via Copy & Paste'''
        
        
        
        : '''Step 1:''' Open the respective wiki article in edit mode. 
        
        : '''Step 2:''' Open your Explorer. Right click on your image, then "edit".
        
        
        
        ::: [[File:CpyPst1.jpg|500x267px]]
        
        
        
        
        
        : <span style="font-size: 0.939em;">Select your image (Ctrl + A):</span>
        
        
        
        
        
        : <span style="font-size: 0.939em;">::::: [[File:CpyPst2.jpg|500x261px]]</span>
        
        
        
        
        
        : <span style="font-size: 0.939em;">::: [[File:CpyPst3.jpg|500x261px]]</span>
        
        
        
        
        
        : <span style="font-size: 0.939em;">Then copy you image (Ctrl + C), go to your wiki article,  move your mouse cursor to the spot in the editor where you want to insert the image and paste image (Ctrl + V):</span>
        
        
        
        
        
        : <span style="font-size: 0.939em;">::: [[File:CpyPst4.jpg|500x284px]]</span>
        
        
        
        
        
        : <span style="font-size: 0.939em;">::: [[File:CopyImage5.jpg|500x289px]]</span>
        
        
        
        ==Features of PasteImage==
        
        
        
        ===Additional data===
        
        
        
        When inserting the image, a pop-up window appears, allowing you to add the following information to the image:
        
        
        
        * The '''categories''' the image can be found in
        
        * A '''summary description''' that will appear on the file page of the image
        
        * The '''license''' the image is under. Note: make sure that you only upload images you are allowed to!
        
        * Furthermore you can place the image on a '''watch list''', so you will always be informed about future changes of the image.
        
        
        
        [[File:PastImage_Infoscreen.png|thumb|center|alt=Screenshot: Adding additional data to the inserted image|400x423px|Screenshot: Adding additional data to the inserted image]]
        
        
        
        ===Further editing of images===
        
        
        
        After inserting an image with PasteImage, you can of course modify it further (resizing, adding alt-text or links, etc.) via the normal functions of your chosen editor.
        
        
        
        [[File:PastImage_Infoscreen_02.png|thumb|center|alt=Screenshot: Further editing of an inserted image|400x287px|Screenshot: Further editing of an inserted image]]
        
        
        
        ==Administration==
        
        
        
        ===How to adapt PasteImage?===
        
        
        
        Administrators can change the following settings in the preference tab PasteImage:
        
        
        
        * '''Default File Extension if none provided'''
        
        * '''Activate Java Applet''' (This setting can also be activated or deactived by the user in the personal user settings under the tab ''BlueSpice'')
        
        
        
        ===Browser compatibility===
        
        
        
        '''PasteImage''' is tested and ready-to-use for
        
        
        
        * Firefox version 22 and higher
        
        * Internet Explorer version 9 and higher
        
        * Chrome version 13 and higher
        
        '''Please note:''' Chrome stopped supporting Java from version 43, so "Copy & Paste" is also not supported anymore. Other features however are not affected.
        
        
        
        ===Troubleshooting===
        
        
        
        * '''Application blocked for security reasons'''
        
        [[File:PasteImage_error.png|thumb|center|alt=Screenshot: Security Blocking Error|400x176px|Screenshot: Security Blocking Error]]
        
        
        
        : If the applet is blocked for security reasons, you can add your wiki to the Exception Site List (required: Java 1.7.0_51 or higher):
        
        
        
        : Step 1: Open your system settings and click on "Java".
        
        
        
        ::: [[File:CpyPst5.jpg|500x281px]]
        
        
        
        : Step 2: Access the "Security" tab and click on "Edit Site List...".
        
        
        
        ::: [[File:CpyPst6.jpg|500x536px]]
        
        
        
        : Step 3: Click "Add" to add your website to the trusted pages.
        
        
        
        [[File:PasteImage_3.png|thumb|center|alt=Screenshot: Exception Site List|400x266px|Screenshot: Exception Site List]]
        
        
        
        : Step 4: Enter the corresponding URL, then click "OK". In the following window, re-check your URL. Click on "Continue".
        
        
        
        [[File:PasteImage_5.png|thumb|center|alt=Screenshot: Security Warning|400x214px|Screenshot: Security Warning]]
        
        
        
        : Step 5: The URL should appear in the Exception Site List. Click "OK" to save your changes.
        
        
        
        [[File:PasteImage_6.png|thumb|center|alt=Screenshot: New Exception Site Entry|400x429px|Screenshot: New Exception Site Entry]]
        
        
        
        : If you are running Java version 1.7.0_40 or 1.7.0_45, you need to import the certificate the applet uses:
        
        
        
        : Step 1: Open your system settings and click on "Java".
        
        
        
        [[File:PasteImage_1.png|thumb|center|alt=Screenshot: System settings|400x225px|Screenshot: System settings]]
        
        
        
        : Step 2: Access the "Security" tab and click on "Manage Certificates...".
        
        
        
        [[File:PasteImage_cert_1.png|thumb|center|alt=Screenshot: Java Control Panel - Security Tab|400x417px|Screenshot: Java Control Panel - Security Tab]]
        
        
        
        : Step 3: Choose "Signer CA" as Certificate type. Click on "Import".
        
        
        
        [[File:PasteImage_cert_2.png|thumb|center|alt=Screenshot: Import Certificate|400x298px|Screenshot: Import Certificate]]
        
        
        
        : Step 4: Choose the <code>pasteImage.crt</code> file. If you can't see the file, choose "All Files" from the "Files of type" dropdown menu. Click on "Open".
        
        
        
        [[File:PasteImage_cert_3.png|thumb|center|alt=Screenshot: Choose pasteImage.crt|400x292px|Screenshot: Choose pasteImage.crt]]
        
        
        
        : Step 5: Verify that you imported the correct certificate. You can see "HalloWelt! - Medienwerkstatt GmbH" as the issuer. Click on "Close".
        
        
        
        [[File:PasteImage_cert_4.png|thumb|center|alt=Screenshot: New certicate entry|400x298px|Screenshot: New certicate entry]]
        
        
        
        : '''Please note:''' regardless of your Java version, always restart your browser for the changes to take effect!
        
        
        
        * '''Stop the applet from asking if you want to execute it'''
        
        
        
        : To stop Java from asking you if you want to execute this applet, you need to import the certificate as described above. In addition to that, with Java version 1.7.0_51 or higher, you need to add your wiki to the trusted sites (as described above).
        
        
        
        : If all is correct, you see the following window:
        
        
        
        [[File:Pasteimage_warning_sites_ok.png|thumb|center|alt=Screenshot: |400x246px|Screenshot: ]]
        
        
        
        : To stop Java asking for permissions for this applet, check the checkbox on the left hand side.
        
        
        
        {| style="border: 1px solid #98A7C4; background-color: #ffffff; border-left: 20px solid #98A7C4; margin-bottom: 0.4em; margin-left: auto; margin-right: auto; width: 100%;" border="0" cellspacing="2" cellpadding="5"
        
        |-
        
        ||
        
        The BlueSpice extension '''PasteImage''' is part of [[BlueSpice pro]]. It can also be purchased as a single extension in the [https://shop.bluespice.com/ BlueSpice Shop].
        
        
        
        |}
        
        
        
        ==See also==
        
        
        
        Our [[PasteImage|reference page.]]