Wiki

Clone wiki

FlickrImport / Home

News

Actually working on the Pixelpost 2 project, this project is no maintained since months.

If you want come to help on PP2 development (code name utltralite2), please go https://github.com/pixelpost/ultralite2

Welcome

FlickrImport is an addon to Pixelpost.

FlickrImport permit you to import all or part of your Flickr's photo stream in your Pixelpost's photo stream. See below what is possible:

  • Choose your photoset to import.
  • Choose size of the imported photo.
  • Choose date of the imported photo.
  • Choose size of the thumbnail.
  • Import photos comments or not.
  • Remove html in photo's comments or not.

How to Install

  1. Upload the folder FlickrImport and the file admin_FlickrImport.php on your addons Pixelpost folder.
  2. Go to your Pixelpost admin panel > addons. Switch FlickrImport to ON.
  3. Go to your Pixelpost admin panel > options > FlickrImport.
  4. Make the authorization good.
  5. Choose your options and select the photosets to sync.
  6. Save your options
  7. Click on the sync link or add the sync script to your crontab.
  8. Enjoy !

How to Update

Just overwrite addons file, FlickrImport automatically detect database changes and update it on next access to the admin panel.

Always go to the FlickrImport option panel in the Pixelpost admin before make new sync.

In case of problem

If you have, any problem with the addon, like empty addon page in the panel, try the debug mode which display errors before create a new issue in the issue tracker.

To turn on the debug mode just append this &flickrimportdebug=1 to the url of the addons page or FlickrImport options in the admin panel.

How it Works

PHOTOSET

The addon create all photoset you choose to sync in the options admin panel in your pixelpost as category.

If you rename a photoset on your flickr, the corresponding category on your pixelpost is not renamed.

If you rename the category on your pixelpost, the link between the category and the photoset is not lost.

If you remove the photoset on your flickr, the category is not deleted on your pixelpost.

If you remove the category on your pixelpost but keep photoset in the sync choice, it is all re-created on the next sync.

PHOTO

There is five options in your admin panel :

Flickr Original size : The addon download the photo in its original size.

Flickr 1024px size : The addon download the photo in its 1024px on the longer side size.

Flickr 500px size : The addon download the photo in its 500px on the longer side size.

Date taken : The photo taken date is registed as the photo date in Pixelpost. This implies that's the photostream in Pixelpost is natural ordered. This is not obligatorily the same order as your Flickr account.

Date upload : The photo upload date in Flickr is registed as the photo date in Pixelpost. This implies that's the photostream in Pixelpost is ordered identical as your Flickr account.

It's possible that's 1024px or 500px photo size don't exists, in this case the photo is not visible in the photo stream. Just remove the photo on your pixelpost admin. Change your FlickrImport option to the original size and make a new sync to download the original size, it's always present.

It is not possible to choose the date upload option and publish the date taken in the photo's informations in your pixelpost.

If your delete a photo on your pixelpost admin, it's re-downloaded on the next sync. Mass-delete on your pixelpost admin, The addon ignore that the photo was deleted and did not download them on the next sync.

If a photo is in different photoset on your Flickr account, the photo is imported in all corresponding category in your pixelpost.

If you remove a photo from a category but still present on the corresponding photoset on Flickr, it is re-added on the next sync.

If you remove a photo from a photoset in your Flickr account, the photo still added in the corresponding categorie on your pixelpost.

If you remove a photo from your Flickr account, the photo still present in your pixelpost.

THUMBNAIL

Importing thumbnail or not, there is three options in your admin panel :

Flickr 100px size : The addon download the thumbnail from flickr, this is very fast but thumbnail is not square.

Flickr 50px size : The addon download the thumbnail from flickr, this is very fast but thumbnail is little and cropped.

Pixelpost thumbnail : The addon let pixelpost generate the thumbnail, this is longer but thumbnail correspond to your choice in your option admin panel.

COMMENT

Importing the photo's comment, there is five options in your admin panel :

Import and publish : The photo's comment are downloaded and directly visible on your photoblog.

Import : The photo's comment are downloaded and but not directly visible on your photoblog, you can allow or disallow in your admin each comment.

No Import : The photo's comment are ignored.

Allow HTML tag : The imported comments looks like Flickr comment. With images, links etc...

Disallow HTML tag : The imported comments have just text. This is usefull for remove all blinking images in your Flickr comment for example.

The Flickr API Key

This add-ons needs to connect on your Flickr account to retreive your photos.

By this way the connection of the addon need an authorization. This is possible with the Flickr API key (see : http://www.flickr.com/services/api/).

The addon use its key to make authorization, you can use your own key, if you want by replacing them into the FlickrImport/common.php file on line 54 and 55.

class FlickrImport
{
    const KEY_API = '9a4cf51154935a525c7e1e0f692017e1';
    const SECRET  = '21675f692ee9720c';

If you allready authorise the addon and change the key, the authorisation is lost.

The addon just need "READ" rights so it can't change anything in your Flickr account.

IMPORTANT

This Pixelpost Addon include a modified part of Phlickr produced by Andrew Morton <drewish@katherinehouse.com> http://sourceforge.net/projects/phlickr/ which is under LGPL license.

Phlickr have actually a little bug concern the urls of thumbnails photo which result in the impossibility to download. The version included here is little modified to fix it. (see Phlickr_Photo::saveAs(), I add one optional argument wich erase the generated url).

This Pixelpost addon is heavily inspired by Pixelpost Importr addon produced by Christian Cueni <chrigu@trivialview.ch> http://www.trivialview.ch which is under GPL license.

REQUIREMENTS

  • PHP 5
  • PHP GD library installed (if you use the pixelpost generate thumbnail or resize option)
  • PHP CURL library installed
  • SimpleXml library installed

LICENCE

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

Updated