User:Flickr upload bot/step-by-step

From Wikimedia Commons, the free media repository
Jump to navigation Jump to search

A step by step guide of Flickr upload bot

  • Step 1. User submits a username and link to Flickr.
    • The submitted link is scanned for the photo_id. All possible variations of links should be recognized, including deep links to the image source.
    • Information is fetched from Flickr.
      • Error is returned if the image does not exists/is private.
      • Error is returned if the image is unfree.
    • User limit is checked.
      • Error is returned if the user has more than 6 uploads the last hour.
      • Username is checked against the Commons database on the Toolserver. Error is returned if the registration date is later than 4 days ago (and not NULL) and user_editcount is less than 50. This function is subject to replag. Due to this replag, legitimate users may be locked out.
      • TODO: Per user permissions and higher limits for admins.
    • Existence of the image on Commons is checked against FlickreviewR's image database. A warning if the image exists.
    • The form for the second step is prepared using information from Flickr.
      • TODO: Integrate with Duesentrieb's tools for categories.
  • Step 2. User submits a form with filename, description and categories.
    • Information about the picture is again fetched, and license is checked again.
    • Check whether the specified filename already exists. Returns to form if this is the case. Subject to replag.
    • Bad characters are stripped from filename, .jpg is appended if not there yet.
    • Timestamp, reviewer, and photo_id are saved to database.
    • The row id in the database is returned as token.
    • {{Flickr}} is prepared, the token is added and outputted.
  • Step 3. The user is automatically redirected to Commons, using Javascript.
  • Step 4. The user saves the prepared data to Commons, including the token.
  • Step 5. The user returns to the web interface.
    • User limit is checked again against database. Subject to replag.
    • License is checked against Flickr.
    • Last revision of the image description page is fetched from Commons (live). User is checked against previously saved information. Token is checked to be belonging to this user and image.
    • Image description page is edited to add the template and license.
    • Image is added to FlickreviewR's database of Flickr images.
    • Success message is outputted to the user.
      • Meanwhile, the uploader is forked.
      • Highest resolution is fetched from Flickr.
      • If the file is the original, the rotation flag is checked, and the image is losslessy rotated using jpegtran.
      • Image is uploaded to Commons.