Fix badge generator URLs and images, and update
script to generate different alt text for the different button styles.
Also change homepage announce link for blog post.
Change-Id: Ibbdc2e8abad3c218d030299eb60ba5bee75db232
diff --git a/docs/html/guide/publishing/publishing.jd b/docs/html/guide/publishing/publishing.jd
index acceecf..b9513ab 100644
--- a/docs/html/guide/publishing/publishing.jd
+++ b/docs/html/guide/publishing/publishing.jd
@@ -320,7 +320,8 @@
<p class="note"><strong>Note:</strong> If you create a link to open Google Play from your web
site and the user selects it from an Android-powered device, the device's Google Play application will
resolve the link so the user can use the Google Play application on the device instead of opening the web
-site. As such, you should always use {@code http://play.google.com/store/...} URIs when creating a link on
+site. As such, you should always use {@code http://play.google.com/store/apps/...} URIs when
+creating a link on
a web page. When pointing to your apps from within your Android app, use the
{@code market://} URIs in an intent, so that the Google Play application always opens.</p>
@@ -333,7 +334,7 @@
<p>The format for the URI that opens the details page is:</p>
-<p style="margin-left:2em"><code><URI_prefix><b>details?id=</b><package_name></code></p>
+<p style="margin-left:2em"><code><URI_prefix><b>apps/details?id=</b><package_name></code></p>
<p>The <code><package_name></code> is a placeholder for the target application's
fully-qualified package name, as declared in the <a
@@ -341,6 +342,8 @@
package}</a> attribute of the <a href="{@docRoot}guide/topics/manifest/manifest-element.html">{@code
<manifest>}</a> element.</p>
+<p>For example: <code>http://play.google.com/store/apps/details?id=com.example.myapp</code></p>
+
<h4>Opening the app details page from your Android app</h4>
@@ -355,12 +358,12 @@
<pre>
Intent intent = new Intent(Intent.ACTION_VIEW);
-intent.setData(Uri.parse("market://details?id=com.android.example"));
+intent.setData(Uri.parse("market://details?id=com.example.android"));
startActivity(intent);
</pre>
<p>This will open the Google Play application on the device to view the {@code
-com.android.example} application.</p>
+com.example.android} application.</p>
<h4>Opening the app details page from a web site</h4>
@@ -369,17 +372,17 @@
format:</p>
<p style="margin-left:2em">
- <code>http://play.google.com/store/details?id=<package_name></code>
+ <code>http://play.google.com/store/apps/details?id=<package_name></code>
</p>
<p>For example, here's a link that opens an application's details page on Google Play:</p>
<pre>
-<a href="http://play.google.com/store/details?id=com.android.example">App Link</a>
+<a href="http://play.google.com/store/apps/details?id=com.example.android">App Link</a>
</pre>
<p>When clicked from a desktop web browser, this opens the Google Play web site to view the
-{@code com.android.example} application. When clicked from an Android-powered device, users are
+{@code com.example.android} application. When clicked from an Android-powered device, users are
given the option to use either their web browser or the Google Play application to view the
application.</p>
@@ -456,17 +459,16 @@
<h3 id="BuildaButton">Build a Google Play button</h3>
-<p>Use the following form to generate a "Get it on Google Play" or "Android App
-on Google Play" button that you can use on your web site. Input either your
-application's package name or publisher name and the button will take users to
-Google Play to either view your application's information or view a list of your
-published apps. If users click the button while on an Android-powered device,
-the Google Play application will respond to show users your application(s).</p>
+<p>Use the following form to create a button for your web site that takes users to your application
+on Google Play. Input either your application's package name or your publisher name and the button
+will take users to Google Play to either view your application's information or view a list of your
+published apps. If users click the button while on an Android-powered device, the Google Play
+application will respond to show users your application(s).</p>
-<p>This form offers four versions of the official brand badges at
-recommended sizes. <!--If you want to create a different size, you can download an EPS file for
-the button images from the <a href="http://www.android.com/branding.html">Android Brand
-Guidelines</a>.</p>-->
+<p>This form offers two styles of the official brand badge each at recommended sizes. You can pick
+between either "Get it on Google Play" or "Android app on Google Play." You should not modify the
+badge images in any way. For more usage guidelines,
+see the <a href="http://www.android.com/branding.html">Android Brand Guidelines</a>.</p>
<style type="text/css">
@@ -510,31 +512,42 @@
var imagePath = "http://www.android.com/images/brand/"
var linkStart = "<a href=\"http://play.google.com/store/";
var imageStart = "\">\n"
- + " <img src=\"" + imagePath;
-var imageEnd = ".png\"\n"
- + " alt=\"Available on Google Play\" />\n</a>";
+ + " <img alt=\"";
+ // leaves opening for the alt text value
+var imageSrc = "\"\n src=\"" + imagePath;
+ // leaves opening for the image file name
+var imageEnd = ".png\" />\n</a>";
// variables for creating code snippet
var linkStartCode = "<a href=\"http://play.google.com/store/";
var imageStartCode = "\">\n"
- + " <img src=\"" + imagePath;
-var imageEndCode = ".png\"\n"
- + " alt=\"Available on Google Play\" />\n</a>";
+ + " <img alt=\"";
+ // leaves opening for the alt text value
+var imageSrcCode = "\"\n src=\"" + imagePath;
+ // leaves opening for the image file name
+var imageEndCode = ".png\" />\n</a>";
/** Generate the HTML snippet and demo based on form values */
function buildButton(form) {
- if (form["package"].value != "com.android.example") {
+ var selectedValue = $('form input[type=radio]:checked').val();
+ var altText = selectedValue.indexOf("get_it") != -1 ? "Get it on Google Play" : "Android app on Google Play";
+
+ if (form["package"].value != "com.example.android") {
$("#preview").show();
- $("#snippet").show().html(linkStartCode + "details?id=" + form["package"].value
- + imageStartCode + $('form input[type=radio]:checked').val() + imageEndCode);
- $("#button-preview").html(linkStart + "details?id=" + form["package"].value
- + imageStart + $('form input[type=radio]:checked').val() + imageEnd);
+ $("#snippet").show().html(linkStartCode + "apps/details?id=" + form["package"].value
+ + imageStartCode + altText + imageSrcCode
+ + selectedValue + imageEndCode);
+ $("#button-preview").html(linkStart + "apps/details?id=" + form["package"].value
+ + imageStart + altText + imageSrc
+ + selectedValue + imageEnd);
} else if (form["publisher"].value != "Example, Inc.") {
$("#preview").show();
$("#snippet").show().html(linkStartCode + "search?q=pub:" + form["publisher"].value
- + imageStartCode + $('form input[type=radio]:checked').val() + imageEndCode);
- $("#button-preview").html(linkStart + "search?q=pub:" + form["publisher"].value + imageStart +
- $('form input[type=radio]:checked').val() + imageEnd);
+ + imageStartCode + altText + imageSrcCode
+ + selectedValue + imageEndCode);
+ $("#button-preview").html(linkStart + "search?q=pub:" + form["publisher"].value
+ + imageStart + altText + imageSrc
+ + selectedValue + imageEnd);
} else {
alert("Please enter your package name or publisher name");
}
@@ -598,13 +611,13 @@
<form class="button-form">
<label class="block" for="package">Package name:</label>
<input class="text" type="text" id="package" name="package"
- value="com.android.example"
- default="com.android.example"
- onfocus="onInputFocus(this, 'com.android.example')"
- onblur="onInputBlur(this, 'com.android.example')"
+ value="com.example.android"
+ default="com.example.android"
+ onfocus="onInputFocus(this, 'com.example.android')"
+ onblur="onInputBlur(this, 'com.example.android')"
onkeyup="return onTextEntered(event, this.parentNode, this)"/>
<a id="package-clear" style="display:none" href="#"
- onclick="return clearLabel('package','com.android.example');">clear</a>
+ onclick="return clearLabel('package','com.example.android');">clear</a>
<p style="clear:both;margin:0"> <em>or</em></p>
<label class="block" style="margin-top:5px" for="publisher">Publisher name:</label>
<input class="text" type="text" id="publisher" name="publisher"
@@ -619,22 +632,22 @@
<div class="button-row">
<input type="radio" name="buttonStyle" value="get_it_on_play_logo_small" id="ns" checked="checked" />
- <label for="ns"><img src="http://www.android.com/images/brand/get_it_on_play_logo_small"
-alt="narrow and small logo" /></label>
+ <label for="ns"><img src="http://www.android.com/images/brand/get_it_on_play_logo_small.png"
+alt="Get it on Google Play (small)" /></label>
- <input type="radio" name="buttonStyle" value="get_it_on_play_logo_large.png" id="nm" />
+ <input type="radio" name="buttonStyle" value="get_it_on_play_logo_large" id="nm" />
<label for="nm"><img src="http://www.android.com/images/brand/get_it_on_play_logo_large.png"
-alt="narrow and large logo" /></label>
+alt="Get it on Google Play (large)" /></label>
</div>
<div class="button-row">
- <input type="radio" name="buttonStyle" value="android_app_on_play_logo_small.png" id="ws" />
+ <input type="radio" name="buttonStyle" value="android_app_on_play_logo_small" id="ws" />
<label for="ws"><img src="http://www.android.com/images/brand/android_app_on_play_logo_small.png"
-alt="wide and small logo" /></label>
+alt="Android app on Google Play (small)" /></label>
- <input type="radio" name="buttonStyle" value="android_app_on_play_logo_large.png" id="wm" />
+ <input type="radio" name="buttonStyle" value="android_app_on_play_logo_large" id="wm" />
<label for="wm"><img src="http://www.android.com/images/brand/android_app_on_play_logo_large.png"
-alt="wide and large logo" /></label>
+alt="Android app on Google Play (large)" /></label>
</div>
<input type="button" onclick="return buildButton(this.parentNode)" value="Build my button"
@@ -644,7 +657,7 @@
<div id="preview" style="display:none">
<p>Copy and paste this HTML into your web site:</p>
- <textarea id="snippet" cols="80" rows="4" onclick="this.select()"
+ <textarea id="snippet" cols="100" rows="5" onclick="this.select()"
style="font-family:monospace;background-color:#efefef;padding:5px;display:none;margin-bottom:1em">
</textarea >
@@ -671,7 +684,7 @@
<tr>
<td>Display the details screen for a specific application</td>
-<td><code>http://play.google.com/store/details?id=<package_name></code>
+<td><code>http://play.google.com/store/apps/details?id=<package_name></code>
<td><code>market://details?id=<package_name></code></td>
</tr>
diff --git a/docs/html/index.jd b/docs/html/index.jd
index 2223860..cfd9ff1 100644
--- a/docs/html/index.jd
+++ b/docs/html/index.jd
@@ -20,7 +20,7 @@
<p>Introducing <strong>Google Play</strong>: An integrated digital content destination where
users buy and enjoy all of their favorite content in one place. It's the new destination for
Android apps!</p>
- <p><a href="http://android-developers.blogspot.com/">Read more »</a></p>
+ <p><a href="http://android-developers.blogspot.com/2012/03/introducing-google-play.html">Read more »</a></p>
</div> <!-- end annoucement -->
</div> <!-- end annoucement-block -->
</div><!-- end topAnnouncement -->
