doc:uploading_images [Knowledge Commons]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
//part of the [[start|GtC documentation]]//

====== Uploading images ======

Being able to upload photos and other images is important for all curators for their own personal home pages (see [[getting an account]]), and then for improving any other pages you create or curate. In Growing the Commons, we pride ourselves in making pages look attractive with the addition of images — a practice we have taken on from [[user:Dave]] and his great Lowimpact site. =)

The [[inserting images]] page explains how to use an image already on the web, in which case there is no need to upload anything, you can just use them from their existing URL. The rest of this page assumes that you need to upload a photo or image that is not already on the web, and that has not yet been uploaded to this wiki.

Once you have understood the process, you can practice uploading on the [[playground:playground]] or on your own home page.

----

===== Uploading with the Media Manager =====

To upload images, we recommend using the Media Manager, available in the spanner icon {{spanner-icon.png}} menu (very top, right), not while you are actually editing a page. You can then insert it any time later, as explained in [[inserting images]].

Again, if the image is on the web already, you don't need to upload it, you can use it from where it is. However, if you are unsure whether it will stay in its place on the web, you can first download the image from the web onto your own computer, and then follow on here.

==== Before you upload ====

Before you upload an image, it's best to get to the page where it will be used. This will make it easier for you, as you won't have to worry about which [[namespace]] it's in. If you want to upload while you are anywhere else (e.g. this very page), you will need to know the namespace of the page you want to use it on. Refresh your understanding of namespaces from the [[namespace]] page.

Also, you will need to be ready with the file you want to upload.

Close any edit you may be on, after saving if desired, before starting uploading with the Media Manager.

==== The uploading process ====

Here's what to do with the Media Manager.
  - Go to the page where you want to use the image or photo.
  - Open the Media Manager (in the spanner icon menu) {{spanner-icon.png}}. 
    - It's easy to back out if you need to. Just go "back" on your browser, or click on the page name in the "Trace" at the top.
  - Click on "Upload", just under the title, between "Media Files" and "Search".\\  You'll notice that just underneath it will say "Upload to …" with the namespace of the page you are on.\\ Then: 
    - either drag your photo file onto where is says "Select files…"  (it changes to "Drop files here to upload");
    - or click on "Select files…" and work through your file system to choose the file you want to upload. 
  - When your file is selected, its name will show. If you need, you can edit the name, e.g. to make it simpler.
  - Click on the big green "Upload" button just below the name of your photo.
  - The file name will then show. You can click on that if you like, to check: on the right, you can see the namespace and filename so you are sure.
  - The image is now uploaded to the namespace you are at.

==== Inserting the image, in brief ====

To use the image you have uploaded, you will write something like this on the page:

`{{nuts.jpg?200|these are nuts}}`, which gives you this image:

{{nuts.jpg?200|these are nuts}} 

If you are still on the page where you were to upload the image, you won't need a namespace.

**Please go to the [[inserting images]] page for the proper fuller explanation.**

----

===== Uploading using the toolbar "Add images…" =====

This is a shortcut which we only suggest if you are comfortable with the above process already.

While you are editing a page, click on the image icon in the edit window toolbar {{image-icon.png|this is an illustration: don't click here!}} to bring up the box for adding an image. The first thing you can do with this pop-up is to check whether the image or photo you want has already been uploaded. The ones in your current [[namespace]] are displayed underneath on the right hand side of the pop-up; you can also search for images in other namespaces by selecting a different namespace on the left.

To carry on, you upload via the toolbar with "Add images…", similar to the process above. You either click the "Select files" button, and choose from your device storage; or you drag a file from your storage onto the place where the "Select files" button is — the button changes momentarily into "Drop files here to upload". When the file is chosen in either way, click on the "Upload" button. When you have done that, your filename appears just above the upload space. Your file has been uploaded, and you continue with the process explained in [[inserting_images#Inserting_images_with_the_toolbar|Inserting images with the toolbar]].

In effect, by using the toolbar to upload, you're doing both processes at once: uploading and inserting. Because they are both relatively complex, until you are comfortable with these techniques, we suggest you do them separately, and use the editing toolbar just for inserting images.