Google ফটোগ্রাফি পুরস্কার গ্যালারি

Ilmari Heikkinen

Google ফটোগ্রাফি পুরস্কার ওয়েবসাইট

আমরা সম্প্রতি Google ফটোগ্রাফি পুরস্কার সাইটে গ্যালারি বিভাগ চালু করেছি। গ্যালারিতে Google+ থেকে নেওয়া ফটোর একটি অসীম স্ক্রোলিং তালিকা দেখানো হয়। এটি একটি AppEngine অ্যাপ থেকে ফটোর তালিকা পায় যা আমরা গ্যালারিতে ফটোর তালিকা মডারেট করার জন্য ব্যবহার করি। এছাড়াও, আমরা Google Code-এ ওপেন সোর্স প্রোজেক্ট হিসেবে গ্যালারি অ্যাপ রিলিজ করেছি।

গ্যালারি পৃষ্ঠা

গ্যালারির ব্যাকএন্ড হল একটি AppEngine অ্যাপ যা Google+ API ব্যবহার করে Google ফটোগ্রাফি পুরস্কারের হ্যাশট্যাগগুলির একটি সহ পোস্টগুলি অনুসন্ধান করে (যেমন #megpp এবং #travelgpp)। তারপর অ্যাপটি সেই পোস্টগুলি তার মডারেট না করা ফটোর তালিকায় যোগ করে। সপ্তাহে একবার, আমাদের কন্টেন্ট টিম মডারেট না করা ফটোর তালিকা চেক করে এবং আমাদের কন্টেন্ট নির্দেশিকা লঙ্ঘন করে এমন ফটো ফ্ল্যাগ করে। 'মডারেট করুন' বোতামে ক্লিক করার পরে, ফ্ল্যাগ না করা ফটোগুলি গ্যালারি পৃষ্ঠায় দেখানো ফটোর তালিকায় যোগ করা হয়।

মডারেশন ব্যাকএন্ড

Google Closure library ব্যবহার করে গ্যালারি ফ্রন্টএন্ড তৈরি করা হয়েছে। গ্যালারি উইজেট নিজেই একটি ক্লোজার কম্পোনেন্ট। সোর্স ফাইলের একদম উপরে আমরা Closure-কে বলি যে এই ফাইল photographyPrize.Gallery নামের কম্পোনেন্ট প্রদান করে এবং অ্যাপের মাধ্যমে ব্যবহার করা Closure লাইব্রেরির অংশ প্রয়োজন:

goog.provide('photographyPrize.Gallery');

goog.require('goog.debug.Logger');
goog.require('goog.dom');
goog.require('goog.dom.classes');
goog.require('goog.events');
goog.require('goog.net.Jsonp');
goog.require('goog.style');

গ্যালারি পৃষ্ঠায় কিছুটা জাভাস্ক্রিপ্ট আছে যা AppEngine অ্যাপ থেকে ফটোর তালিকা ফিরিয়ে আনতে JSONP ব্যবহার করে। JSONP হল একটি সহজ ক্রস-অরিজিন জাভাস্ক্রিপ্ট হ্যাক যা jsonpcallback("responseValue")-এর মতো দেখতে একটি স্ক্রিপ্ট ইনজেক্ট করে। JSONP সংক্রান্ত বিষয় ম্যানেজ করতে, আমরা Closure লাইব্রেরিতে goog.net.Jsonp কম্পোনেন্ট ব্যবহার করছি।

গ্যালারি স্ক্রিপ্ট ফটোর তালিকা চেক করে এবং গ্যালারি পৃষ্ঠায় দেখানোর জন্য সেগুলির HTML এলিমেন্ট তৈরি করে। উইন্ডো স্ক্রল ইভেন্টের সাথে যুক্ত হয়ে এবং উইন্ডো স্ক্রল পৃষ্ঠার নিচের দিকে পৌঁছালে ফটোর নতুন ব্যাচ লোড করার মাধ্যমে ইনফিনিট স্ক্রলিং কাজ করে। নতুন ফটো তালিকার সেগমেন্ট লোড করার পরে, গ্যালারি স্ক্রিপ্ট ফটোর জন্য এলিমেন্ট তৈরি করে এবং সেগুলি দেখানোর জন্য গ্যালারি এলিমেন্টে যোগ করে।

ছবির তালিকা দেখানো হচ্ছে

ছবির তালিকা দেখানোর পদ্ধতিটি খুবই সাধারণ। এটি ছবির তালিকা চেক করে, HTML এলিমেন্ট ও +১ বোতাম তৈরি করে। পরবর্তী ধাপ হল, জেনারেট করা তালিকা সেগমেন্ট গ্যালারির মূল গ্যালারি এলিমেন্টে যোগ করা। আপনি নিচের কোডে কিছু ক্লোজার কম্পাইলার কনভেনশন দেখতে পাবেন, JSDoc কমেন্টে টাইপ ডেফিনেশন এবং @private দৃশ্যমানতা লক্ষ্য করুন। প্রাইভেট মেথডের নামের পরে আন্ডারস্কোর (_) থাকে।

/**
 * Displays images in imageList by putting them inside the section element.
 * Edits image urls to scale them down to imageSize x imageSize bounding
 * box.
 *
 * @param {Array.<Object>} imageList List of image objects to show. Retrieved
 *                                   by loadImages.
 * @return {Element} The generated image list container element.
 * @private
 */
photographyPrize.Gallery.prototype.displayImages_ = function(imageList) {
  
  // find the images and albums from the image list
  for (var j = 0; j < imageList.length; j++) {
    // change image urls to scale them to photographyPrize.Gallery.MAX_IMAGE_SIZE
  }

  // Go through the image list and create a gallery photo element for each image.
  // This uses the Closure library DOM helper, goog.dom.createDom:
  // element = goog.dom.createDom(tagName, className, var_childNodes);

  var category = goog.dom.createDom('div', 'category');
  for (var k = 0; k < items.length; k++) {
    var plusone = goog.dom.createDom('g:plusone');
    plusone.setAttribute('href', photoPageUrl);
    plusone.setAttribute('size', 'standard');
    plusone.setAttribute('annotation', 'none');

    var photo = goog.dom.createDom('div', {className: 'gallery-photo'}, ...)
    photo.appendChild(plusone);

    category.appendChild(photo);
  }
  this.galleryElement_.appendChild(category);
  return category;
};

স্ক্রল ইভেন্ট ম্যানেজ করা

ভিজিটর কখন স্ক্রল করে পৃষ্ঠার নিচে পৌঁছেছেন এবং আমাদের কখন নতুন ছবি লোড করতে হবে তা দেখতে, গ্যালারি উইন্ডো অবজেক্টের স্ক্রল ইভেন্টের সাথে যুক্ত হয়। ব্রাউজার ইমপ্লিমেন্টেশনের পার্থক্যগুলি আড়াল করতে, আমরা ক্লোজার লাইব্রেরি থেকে কিছু সুবিধাজনক ইউটিলিটি ফাংশন ব্যবহার করছি: goog.dom.getDocumentScroll() বর্তমান ডকুমেন্ট স্ক্রল পজিশন সহ একটি {x, y} অবজেক্ট রিটার্ন করে, goog.dom.getViewportSize() উইন্ডোর সাইজ রিটার্ন করে এবং goog.dom.getDocumentHeight() HTML ডকুমেন্টের উচ্চতা রিটার্ন করে।

/**
 * Handle window scroll events by loading new images when the scroll reaches
 * the last screenful of the page.
 *
 * @param {goog.events.BrowserEvent} ev The scroll event.
 * @private
 */
photographyPrize.Gallery.prototype.handleScroll_ = function(ev) {
  var scrollY = goog.dom.getDocumentScroll().y;
  var height = goog.dom.getViewportSize().height;
  var documentHeight = goog.dom.getDocumentHeight();
  if (scrollY + height >= documentHeight - height / 2) {
    this.tryLoadingNextImages_();
  }
};

/**
 * Try loading the next batch of images objects from the server.
 * Only fires if we have already loaded the previous batch.
 *
 * @private
 */
photographyPrize.Gallery.prototype.tryLoadingNextImages_ = function() {
  // ...
};

ছবি লোড হচ্ছে

সার্ভার থেকে ছবি লোড করতে, আমরা goog.net.Jsonp কম্পোনেন্ট ব্যবহার করছি। কোয়েরি করতে goog.Uri লাগে। তৈরি করা হয়ে গেলে, আপনি কোয়েরি প্যারামিটার অবজেক্ট ও সাকসেস কলব্যাক ফাংশন সহ Jsonp প্রদানকারীকে কোয়েরি পাঠাতে পারবেন।

/**
 * Loads image list from the App Engine page and sets the callback function
 * for the image list load completion.
 *
 * @param {string} tag Fetch images tagged with this.
 * @param {number} limit How many images to fetch.
 * @param {number} offset Offset for the image list.
 * @param {function(Array.<Object>=)} callback Function to call
 *        with the loaded image list.
 * @private
 */
photographyPrize.Gallery.prototype.loadImages_ = function(tag, limit, offset, callback) {
  var jsonp = new goog.net.Jsonp(
      new goog.Uri(photographyPrize.Gallery.IMAGE_LIST_URL));
  jsonp.send({'tag': tag, 'limit': limit, 'offset': offset}, callback);
};

উপরে যেমন উল্লেখ করা হয়েছে, গ্যালারি স্ক্রিপ্ট কোড কম্পাইল ও ছোট করার জন্য Closure কম্পাইলার ব্যবহার করে। Closure কম্পাইলার সঠিক টাইপিং এনফোর্স করার ক্ষেত্রেও উপযোগী (আপনি কোনও প্রপার্টির ধরন সেট করার জন্য আপনার কমেন্টে @type foo JSDoc নোটেশন ব্যবহার করেন) এবং কোনও পদ্ধতির জন্য আপনার কাছে কমেন্ট না থাকলে এটি আপনাকে তা জানায়।

ইউনিট টেস্ট

এছাড়াও, আমাদের গ্যালারি স্ক্রিপ্টের জন্য ইউনিট টেস্টের প্রয়োজন ছিল, তাই Closure লাইব্রেরিতে ইউনিট টেস্টিং ফ্রেমওয়ার্ক বিল্ট-ইন থাকায় সুবিধা হয়েছে। এটি jsUnit কনভেনশন অনুসরণ করে, তাই এটি শুরু করা সহজ।

ইউনিট টেস্ট লেখার ব্যাপারে সাহায্য পেতে, আমি একটি ছোট Ruby স্ক্রিপ্ট লিখেছি যা JavaScript ফাইল পার্স করে এবং গ্যালারি কম্পোনেন্টের প্রতিটি পদ্ধতি ও প্রপার্টির জন্য একটি ব্যর্থ ইউনিট টেস্ট তৈরি করে। এই ধরনের স্ক্রিপ্ট দেওয়া হলে:

Foo = function() {}
Foo.prototype.bar = function() {}
Foo.prototype.baz = "hello";

টেস্ট জেনারেটর প্রতিটি প্রপার্টির জন্য একটি খালি টেস্ট তৈরি করে:

function testFoo() {
  fail();
  Foo();
}

function testFooPrototypeBar = function() {
  fail();
  instanceFoo.bar();
}

function testFooPrototypeBaz = function() {
  fail();
  instanceFoo.baz;
}

এই অটোমেটিক জেনারেট করা টেস্টগুলি আমাকে কোডের জন্য টেস্ট লেখার ক্ষেত্রে একটি সহজ সূচনা দিয়েছে এবং সমস্ত পদ্ধতি এবং প্রপার্টি ডিফল্টভাবে কভার করা হয়েছে। টেস্ট ফেল করার ফলে একটি সুন্দর মনস্তাত্ত্বিক প্রভাব তৈরি হয় যেখানে আমাকে এক এক করে টেস্টের মাধ্যমে যেতে হয় এবং সঠিক টেস্ট লিখতে হয়। কোড কভারেজ মিটারের সাথে যুক্ত, এটি একটি মজাদার গেম যা টেস্ট এবং কভারেজকে সবুজ করে তোলে।

সারাংশ

Gallery+ হল একটি ওপেন সোর্স প্রোজেক্ট যা #হ্যাশট্যাগের সাথে মিল থাকা Google+ ফটোর একটি মডারেট করা তালিকা দেখায়। এটি Go এবং ক্লোজার লাইব্রেরি ব্যবহার করে তৈরি করা হয়েছে। ব্যাকএন্ড App Engine-এ চলে। Google ফটোগ্রাফি পুরস্কার ওয়েবসাইটে জমা দেওয়া ছবি দেখানোর জন্য Gallery+ ব্যবহার করা হয়। এই নিবন্ধে আমরা ফ্রন্টএন্ড স্ক্রিপ্টের গুরুত্বপূর্ণ অংশগুলি নিয়ে আলোচনা করেছি। App Engine ডেভেলপার রিলেশন টিমের আমার সহকর্মী জোহান ইউফ্রোসিন ব্যাকএন্ড অ্যাপ সম্পর্কে দ্বিতীয় নিবন্ধটি লিখছেন। ব্যাকএন্ডটি Go-তে লেখা হয়েছে, যা Google-এর নতুন সার্ভার-সাইড ভাষা। তাই আপনি যদি Go কোডের প্রোডাকশন উদাহরণ দেখতে আগ্রহী হন, তাহলে সাথে থাকুন!

রেফারেন্স