How to install django-picasa
- Download and install ActivePython
- Open Command Prompt
- Type
pypm install django-picasa
Lastest release
How to use django-googledata.picasa
I'm pretty useless at documentation so I will just guide you through how I use these components in my web site.
Prerequisites
Before you start you will need to install google's python api. easy_install will do that for you.
Installing
Okay lets go. Either do:: easy_install django-picasa
Or download the distribution file into your temp or just check out the picassa module into your project's directory. Run python setup.py:: C: emp> C: emp>python setup.py install --install-purelib="C:your_project" running install running build running build_py creating build creating buildlib creating buildlibpicasa copying picasa ields.py -> buildlibpicasa copying picasastorage.py -> buildlibpicasa copying picasa__init__.py -> buildlibpicasa running install_lib creating C:your_project_rootpicasa copying buildlibpicasa ields.py -> C:your_projectpicasa copying buildlibpicasastorage.py -> C:your_projectpicasa copying buildlibpicasa__init__.py -> C:your_projectpicasa byte-compiling C:your_projectpicasa ields.py to fields.pyc byte-compiling C:your_projectpicasastorage.py to storage.pyc byte-compiling C:your_projectpicasa__init__.py to __init__.pyc running install_egg_info Writing C:your_project_rootdjango-googledata-1.0-py2.5.egg-info
settings.py
Add the framework to the INSTALLED_APPS tuple of your projects settings.py file:: INSTALLED_APPS = ( 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', 'django.contrib.admin', 'examplesite.archive', 'picasa' )
Then add to the settings.py file your PICASA_STORAGE_OPTIONS:: PICASA_STORAGE_OPTIONS = { 'email':'thanosv@gmail.com', 'source':'thanos', 'password':'mypassword', 'userid':'thanosv', 'cache': True}
Where: email is your Picasa account id. source is a string you will use to identify how the images where added to your Picasa account. userid is the actual Picassa account that the images will stored in. It doesn't have to be your account just any account you have the access to. cache is weather you want to use Django's caching back-end. Usually it's worth it.
If you have set cache to true they you might want to add something like this:: CACHE_BACKEND = "locmem://?timeout=30&max_entries=400"
models.py
Now you are done with the settings.py file you can replace the ImageFields? with the picasa field in your models:
from picasa import PicasaField class Image(models.Model): photo = PicasaField( )
Try it out by uploading an image through your admin page and then visit your Picasa account. You will see the uploaded image in your Drop Box. Added a upload_to='media':: photo = PicasaField( upload_to='media')
and it will upload the file into an album called media, if the album doesn't exist it will be created.
admin.py
The default admin representaion of your image will be handled by the AdminFileWidget which will just show the value of PicasaField.url of the containing web page in your Picasa account. It's useful but would be better to see a linked thumbnail. To do that you need to override the PicasaField with PicasaAdminImageWidget. To do that import the widget in your admin.py module and add it to an formfield_overrides dictionary: :
By default PicasaAdminImageWidget? generates a 64 pixel icon. The sizes available are:: class PicasaFieldFile(ImageFieldFile): SIZES = (32, 48, 64, 72, 94, 104, 110, 128, 144, 150, 160, 200, 220, 288, 320, 400, 512, 576, 640, 720, 800, 912, 1024, 1152, 1280, 1440, 1600)
You can override the class attribute SIZE to change the thumbnail's size:: class ImageWidget(PicasaAdminImageWidget): SIZE='48'
class ImageAdmin(admin.ModelAdmin): formfield_overrides = {PicasaField: {'widget': ImageWidget},}
views.py
Using the above demo model here is a quick view:: def images(request): return render_to_response('archive/images.html', {'images':Image.objects})
Here is its corresponding template (templates/archive/images.html) :: <h2>Image List</h2> {% for image in images.all %} <a href="{{image.photo.url}}"><img src="{{image.photo.src}}" width="300"/></a><br/> {% endfor %}
and the html it produces:
<h2>Image List</h2> <a href="http://picasaweb.google.com/thanosv/Media04#5434869420740374642"><img src="http://lh6.ggpht.com/_w0eENG7V9Qg/S2yI8Wfc8HI/AAAAAAAAAdQ/xrYdkgQF8r0/itunesscreenshot.jpg" width="300"/></a><br/> <a href="http://picasaweb.google.com/thanosv/Media04#5435910379245055122"><img src="http://lh3.ggpht.com/_w0eENG7V9Qg/S3A7sHHCrJI/AAAAAAAAAdw/QMY9OIviHB0/thanos.jpg" width="300"/></a><br/>
Different Sizes
Although this HTML saves your site a lot of bandwidth your images are at the mercy of the browsers resizes and when the original images are large will still be slow to download.
Changing the image source variables to indicate the size they need by using image.photo.src_300 instead of image.photo.src gets Picasa to do the resizing and greatly speeds up the download. requesting an image of the width 300 will in fact get you 320, which is the next available size up:: <h2>Image List</h2> {% for image in images.all %} <a href="{{image.photo.url}}"><img src="{{image.photo.src_300}}" width="300"/></a><br/> {% endfor %}
And its HTML:: <h2>Image List</h2> <a href="http://picasaweb.google.com/thanosv/Media04#5434869420740374642"><img src="http://lh6.ggpht.com/_w0eENG7V9Qg/S2yI8Wfc8HI/AAAAAAAAAdQ/xrYdkgQF8r0/s320/itunesscreenshot.jpg" width="300"/></a><br/> <a href="http://picasaweb.google.com/thanosv/Media04#5435910379245055122"><img src="http://lh3.ggpht.com/_w0eENG7V9Qg/S3A7sHHCrJI/AAAAAAAAAdw/QMY9OIviHB0/s320/thanos.jpg" width="300"/></a><br/>
Possible Problems
If you are behind a proxy and you get the following error when you try an upload an image:: gaierror at /admin/archive/image/add/ (11001, 'getaddrinfo failed')
Check that you have set both HTTP_PROXY and HTTPS_PROXY. HTTPS_PROXY can usually be set to the same host as HTTP_PROXY.
Please see http://code.google.com/p/django-googledata/ for more information.