[extensions-web] Add a new "About" page to answer questions about GNOME Shell Extensions

[Jasper St. Pierre <jstpierre src gnome org>]

commit 24175e4d03bae115f7de64e81a6edbb3669c2142
Author: Jasper St. Pierre <jstpierre mecheye net>
Date:   Mon Nov 28 15:20:06 2011 -0500

    Add a new "About" page to answer questions about GNOME Shell Extensions

 .../extensions/templates/extensions/about.html     |   22 ++++++++++++++++++++
 sweettooth/extensions/urls.py                      |    2 +
 sweettooth/static/css/template.css                 |    1 +
 sweettooth/static/js/extensions.js                 |    5 +++-
 sweettooth/templates/base.html                     |    1 +
 5 files changed, 30 insertions(+), 1 deletions(-)
---
diff --git a/sweettooth/extensions/templates/extensions/about.html b/sweettooth/extensions/templates/extensions/about.html
new file mode 100644
index 0000000..c5f703d
--- /dev/null
+++ b/sweettooth/extensions/templates/extensions/about.html
@@ -0,0 +1,22 @@
+{% extends "base.html" %}
+{% block title %}What's this? - {{ block.super }}{% endblock %}
+{% block body %}
+<h2> What is GNOME Shell? </h2>
+<p>GNOME Shell is the biggest new feature of <a href="http://www.gnome3.org/";>GNOME 3</a>. If you're using GNOME 3 right now, it's the big black bar at the top of your screen. It's also that "Activities" place you go to to switch tasks.</p>
+<h2> What are GNOME Shell Extensions? </h2>
+<p>GNOME Shell Extensions are things that you can add on to GNOME 3 and GNOME Shell, like Chrome Extensions or Firefox Addons.</p>
+<h2> What can GNOME Shell Extensions do? </h2>
+<p>When you install a GNOME Shell Extension, this adds new functionality to your OS. Extensions may make small changes, like moving your clock to the right-hand side of the screen, or make big changes, like laying out the windows in the "Activities" mode in a different way.</p>
+<h2> Are GNOME Shell Extensions safe? </h2>
+<p>Because of the wide variety of changes that we want GNOME Shell Extensions to make, it's pretty tricky to make sure they're secure. We don't want to negatively impact your system, but note that GNOME Shell Extensions may cause slowdown or make your system crash. If you've installed an extension like this, please report it to the extension author &mdash; chances are they want to fix these problems, too!</p>
+<p> As an additional security measure, every one of the extensions listed on this website has had its code personally reviewed by a GNOME Shell Developer to the best of their abilities to ensure that people can't steal system information or pop up ads.</p>
+<h2> I don't think I have GNOME Shell. What can I do to get it? </h2>
+<p> The easiest way to get GNOME Shell along with GNOME 3 is to install a Linux distribution with GNOME 3 and GNOME Shell installed. See the <a href="http://www.gnome.org/getting-gnome/";>Getting GNOME</a> page on the main GNOME site to learn how to grab a Linux distribution with GNOME 3.</p>
+<h2 id="old-version"> I'm using GNOME 3 right now! Why doesn't your stupid site recognize it? </h2>
+<p> Make sure you're using GNOME 3.2 or later, not GNOME 3.0, and make sure you have the "GNOME Shell Extension Integration" browser plugin enabled. GNOME 3.2 added the browser plugin and necessary hooks in GNOME Shell to make this website possible, so this website does not support and will never support integration with GNOME 3.0.</p>
+
+</p>Note: there were some bugs in the browser plugin shipped in GNOME 3.2 that prevent it from working properly under WebKit-based browsers like Epiphany and Chromium. These bugs have been fixed and should be released when GNOME 3.4 ships at the beginning of March, next year. Use Firefox for now.</p>
+
+{% endblock %}
+
+{% block navclass %}about{% endblock %}
diff --git a/sweettooth/extensions/urls.py b/sweettooth/extensions/urls.py
index c0bba63..8e36065 100644
--- a/sweettooth/extensions/urls.py
+++ b/sweettooth/extensions/urls.py
@@ -41,6 +41,8 @@ urlpatterns = patterns('',
                                  template_name='extensions/list.html'),
         name='extensions-index'),
 
+    url(r'^about/$', direct_to_template, dict(template='extensions/about.html'), name='extensions-about'),
+
     # we ignore PK of extension, and get extension from version PK
     url(r'^extension/(?P<ext_pk>\d+)/(?P<slug>.+)/version/(?P<pk>.*)/$',
         views.extension_version_view, name='extensions-version-detail'),
diff --git a/sweettooth/static/css/template.css b/sweettooth/static/css/template.css
index 39e8ea7..3b2ed79 100644
--- a/sweettooth/static/css/template.css
+++ b/sweettooth/static/css/template.css
@@ -242,6 +242,7 @@ a:visited {
 #globalnav.main li.main a,
 #globalnav.upload li.upload a,
 #globalnav.local li.local a,
+#globalnav.about li.about a,
 #globalnav li.active a {
     background: #7fa7d4;
     padding: 5px 15px;
diff --git a/sweettooth/static/js/extensions.js b/sweettooth/static/js/extensions.js
index 336831e..535740b 100644
--- a/sweettooth/static/js/extensions.js
+++ b/sweettooth/static/js/extensions.js
@@ -37,7 +37,10 @@ function($, messages, dbusProxy, extensionUtils) {
         dbusProxy.ShellVersion === undefined) {
         // We don't have a proper DBus proxy -- it's probably an old
         // version of GNOME3 or the Shell.
-        messages.addError("You do not appear to have an up to date version of GNOME3. Some parts of the website may be disabled.");
+        messages.addError("You do not appear to have an up to date version " +
+                          "of GNOME3. You won't be able to install extensions " +
+                          "from here. See the <a href=\"/about/#old-version\">about page</a> " +
+                          "for more information");
 
         $.fn.addExtensionSwitch = function() {
             // Don't show our switches -- CSS styles define a clickable
diff --git a/sweettooth/templates/base.html b/sweettooth/templates/base.html
index 0e59e12..6b47a55 100644
--- a/sweettooth/templates/base.html
+++ b/sweettooth/templates/base.html
@@ -52,6 +52,7 @@ window._SW = function() {
         <h1><a href="/"><img src="/static/images/foot.png" alt="GNOME" />Shell Extensions</a><span class="alpha-banner">Alpha!</span></h1>
         
         <ul id="globalnav" class="{% block navclass %}{% endblock %}">
+          <li class="about"><a href="{% url extensions-about %}">What's this?</a></li>
           <li class="main"><a href="{% url extensions-index %}">Extensions</a></li>
           <li class="upload"><a href="{% url extensions-upload-file %}">Add yours</a></li>
           <li class="local"><a href="{% url extensions-local %}">Installed extensions</a></li>