Tuesday, November 9, 2010

How to make a web site re-usable by third parties

One of the big challenges of our project was to turn what was essentially designed as a regular database-driven web site into a re-usable application. By 're-usable' here we mean that your typical university sysadmin could take our package and turn it into a PhilPapers-like site that doesn't look too much like PhilPapers. No programming needed, but modifying config files and templates is OK.

The big challenge in here is preserving the upgrade path. PhilPapers is built with HTML::Mason, a template system. We have hundreds of template files of all sizes. If someone copied our source tree and started modifying the templates to adapt them to their needs, they would soon end up with a system that is all but impossible to update with our latest code. A similar problem arises with the many data files and image files that support the site.

Our solution to this problem is to extend the concept of differential programming found in OO programming to templates. Think of our template files as methods of a big Template class. So our header file is a method, our footer file is another, and everything that goes in-between is a method too. A natural way to refine an existing class is to override just the methods you need to change, keeping the originals intact in the superclass. That's what we've done with our templates.

We achieved that by defining several component roots in Mason (the component roots are paths relative to which Mason looks for template files). Suppose we have an incoming request for the /news.html component on PhilPapers. For PhilPapers we have two component roots; let's pretend they are /var/philpapers and /var/xpapers. The latter contains the default templates that ship with xPapers, while the former contains only the overrides required to give PhilPapers its unique look and structure. If template /news.html is requested, Mason first looks in our /var/philpapers/ tree of templates. If there's a /var/philpapers/news.html file, it will use it and ignore /var/xpapers/news.html. If not, it will revert to /var/xpapers/news.html.

Another challenge is maintaining the upgrade path of the database schema. Here we plan to use the same system that we use internally to maintain the schema through git: each change to the schema is saved in a file with the table's name, and we have a script that keeps track of what lines in what files have been executed. That works pretty well, except when we want to roll back some changes. When that happens we simply add more lines which have the effect of rolling back the changes. There's also a theoretical issue about order of execution and foreign key constraints, but in hundreds of updates we have never run into that because we hardly use foreign key constraints with MySQL. If needed we could get around this by adding the constraints to a file whose lines are always executed last. This system isn't as robust as Ruby migrations, but it is lightweight, efficient, and (almost) fun to use.



39 comments:

  1. tiffany and co jewelry, http://www.tiffanyandco.in.net/
    prada handbags, http://www.pradahandbagsoutlet.co.uk/
    louis vuitton handbags, http://www.louisvuittonhandbag.us/
    tiffany jewellery, http://www.tiffanyjewelleryoutlets.co.uk/
    hermes belt, http://www.hermesbelts.us/
    ugg outlet, http://www.uggsoutlet.us.org/
    karen millen dresses, http://www.karenmillendressesoutlets.co.uk/
    replica watches, http://www.replicawatchesforsale.us.com/
    christian louboutin online, http://www.christianlouboutinonline.us.com/
    canada goose jackets, http://www.uggbootscheap.eu.com/
    gucci, http://www.borseguccioutlet.it/
    air jordan shoes, http://www.airjordanshoes.us.org/
    the north face outlet store, http://www.thenorthfaceoutletstores.org/
    louis vuitton, http://www.louisvuitton.in.net/
    ugg boots, http://www.uggbootsclearance.in.net/
    nobis outlet, http://www.wellensteyn.com.co/
    ray ban sunglasses, http://www.raybansunglassesonline.us.com/
    snow boots, http://www.wintercoats.us.com/
    lebron james shoes, http://www.lebronjames.us.com/
    beats by dr dre, http://www.beatsbydrdre-headphones.us.com/
    michael kors factory outlet, http://www.michaelkorsfactoryoutlets.in.net/
    cheap nhl jerseys, http://www.nhljerseys.us.com/
    montblanc pens, http://www.montblanc-pens.com.co/
    vans shoes, http://www.vans-shoes.cc/
    dansko outlet, http://www.dansko-shoes.us/
    2015109caihuali

    ReplyDelete
  2. Tahukah anda Antara 50 hingga 90% dari orang-orang yang bekerja di depan layar komputer memiliki beberapa gmasalah yang cukup serius dengankesehatan matanya
    Obat Radang Ginjal Nefritis
    Obat Disfungsi Ereksi Yang Aman
    Penyebab Anyang Anyangan Yang Berkepanjangan

    ReplyDelete


  3. افضل شركة نقل اثاث بالمدينة المنورة تساعدك على نقل اثاثك بامان فلا داعى للقلق مع افضل شركة نقل اثاث بجدة

    عزيزى العميل انت من محبى التنقل باستمرار بالتالى انت بحاجة ماسة وضروية الى الاستعانة بالمختصين في نقل العفش خاصة ارخص شركة نقل اثاث بالرياض لان الاستعانة باى من عمالة الشوارع الغير مدربة والتي لا تمتلك خبرة كافية في نقل العفش او الحفاظ علية وليس هذا فقط فقد يؤدى الاستعانة بعمالة الشوارع الى حدوث حالة فقدان وتكسير للاثاث بالتالى التاثير الضار عليك عزيزى العميل

    لا تقلق مطلقاً الان بشأن نقل اي منقولات خاصة بك طالما استعنت بشركة الاول لـ نقل الأثاث في الرياض وخارج الرياض فنحن ليس الوحيدون ولكننا متميزون عن اى مؤسسة أخرى داخل وخارج الدمام وشهرتنا كافضل شركة نقل عفش بينبع
    نقل اثاث بجدة

    ReplyDelete
  4. It is really hard to say when exactly need to cash your check. Sometimes it may very difficult to cash if it is not official hours
    check cashing

    ReplyDelete
  5. On the off chance that you end up requiring a payday advance, recollect to pay it back before the due date. www.usacheckcashingstore.com/san-diego

    ReplyDelete
  6. A payday advance is intended to help individuals beat here and now issues; accordingly they are accessible for little sums up to £750. usapaydayloanstore.com/chicago

    ReplyDelete
  7. "Welcome to the web experts treatment of various types of diseases, do not forget to get the best health solutions here"
    Cara Mengobati Beri Beri

    ReplyDelete
  8. Really endure in mind United States and that we can money your test terribly brief amount with a virtually low charge.check casher Philadelphia

    ReplyDelete
  9. This rate is determined in advance, and you have the option of specifying the budget you wish to be utilized per day or monthly. Hence, it is very flexible to execute.

    ReplyDelete
  10. It was a decent post undoubtedly. I completely delighted in understanding it in my lunch time. Will most likely come and visit this blog all the more regularly. A debt of gratitude is in order for sharing. blog comments

    ReplyDelete
  11. You know after a hard day I decided to have fun and play games of chance I climbed a bunch of sites and only on this I understood what was happening prosperous best rated online casinos now I sit and spend all the time on this site

    ReplyDelete
  12. Garden parties were very popular in England during the Victorian age as well as in India but now they are hosted in the landscaped areas of almost all the major cities of the world. hot strippers

    ReplyDelete
  13. This was a shocking post. It has some look at here fundamental data on this subject. Wondering where to go in 2019? Things to do has ranked as the best include a remote, idyllic island, the design capital ...

    ReplyDelete

  14. The girls here with us would never call you once your booking is over. This is one of the reasons why we here at the house ofRussian Escorts in Gurgaon have earned ourselves a great reputation and a goodwill that is surely unmatchable. Check our other Services...
    Call Girls in Gurgaon
    Escorts Service in Gurgaon
    Russian Call Girls in Gurgaon
    Russian Escorts in Gurgaon
    Russian Escorts in Gurgaon
    Russian Call Girls in Gurgaon

    ReplyDelete
  15. I think this is an informative post and it is very useful and knowledgeable. therefore, I would like to thank you for the efforts you have made in writing this article. Dofollow SEO Backlink

    ReplyDelete
  16. I am interested in such topics so I will address page where it is cool described. Shisha Hire

    ReplyDelete
  17. These off-duty flight attendants are willing to do almost everything to amuse our clients.Hotel Sex Service in Lucknow Our off-duty flight attendants are all about class since they earn a fair amount of money from the airline profession.Low budget Call Girls in Lucknow Each of these Housewife Call Girls in Agra has never fails to bring a smile to the faces of Call Girls whatsapp number in Dehradun the clients once the booking is through and Call Girls whatsapp number in Dehradun this is the reason why our Punjabi Escorts in Faridabad clients make repeat bookings for each one of these babes regularly.

    ReplyDelete
  18. If you are looking to hire a top-rated SEO company in Toronto, you have landed at the right place. We have over 10 years of experience in ranking websites from different industry verticals on top of the search results. Get in touch with us for more details.

    ReplyDelete
  19. Multilingua is the best foreign language institute in Delhi that offers the best in-its-class language Education, IELTS training & personalized guidance to students who wish to learn and are willing to try new and unfamiliar things. We are also one of the BEST language & IELTS coaching, IELTS Training Course, English Language Course, German Language Course, French Language Institute, Chinese Language Classes in Delhi, Language Translation services, provide training to a large number of students every year who are looking to work & study Abroad.

    ReplyDelete
  20. Multilingua provides the best IELTS Coaching in Delhi that offers thebest in-its-class language Education, IELTS training & personalizedguidance to students who wish to learn and are willing to try new and unfamiliar things. We also provide the best English speaking courses,  Spanish language courses, Chinese language courses, French language
    courses, and Translation services in Delhi.

    ReplyDelete
  21. This comment has been removed by the author.

    ReplyDelete