AMP for WordPress

Mô tả

Bring the speed and features of the open source AMP project to your site, the WordPress way.

With the plugin active, all posts on your site will have AMP-compatible versions, accessible by appending /amp/ to the end your post URLs. For example, if your post URL is http://example.com/2016/01/01/amp-on/, you can access the AMP version at http://example.com/2016/01/01/amp-on/amp/. If you do not have pretty permalinks enabled, you can do the same thing by appending ?amp=1, i.e. http://example.com/?p=123&amp=1

Also, your pages and custom post types can have AMP versions. Simply check their boxes on the ‘AMP Settings’ page in /wp-admin.

Your entire site can render as “Native AMP” if your theme calls add_theme_support( 'amp' ). There will only be one version of each URL: the AMP version. There won’t be separate URLs with /amp or ?amp appended. See this wiki page for details and restrictions.

Your theme can also use Paired Mode, with your own custom templates for the AMP URLs.

“Native AMP” and “Paired Mode” add full support for commenting and widgets.

If your theme doesn’t support 'amp', this will use basic legacy post templates for AMP consumers like Google Search and Twitter. And when visiting the site, the AMP content won’t normally appear without appending strings to the URL like /amp or ?amp.

Follow along with or contribute to the development of this plugin on GitHub. For more information on the plugin, how the plugin works and how to configure and extend it, please see the project wiki.

Ảnh màn hình

  • Post rendered in AMP template.
  • Customizing appearance of AMP template.
  • Article from New York Post showing customized AMP template.
  • Article from TNW showing customized AMP template.
  • Article from Halfbrick showing customized AMP template.

Cài đặt

  1. Upload the folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. You may need to refresh your permalinks by going to Settings > Permalinks and tapping the Save button.

Hỏi đáp

Installation Instructions
  1. Upload the folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. You may need to refresh your permalinks by going to Settings > Permalinks and tapping the Save button.

Đánh giá

Do the job but no magical

Don’t get wrong this isn’t perfect but converting a website to AMP basically require to rewrite all code / make another theme. This allow you to do it freely without much effort but it is of course can’t deal with any wordpress structure / PHP code.

You can make your own theme with it by adding an amp folder inside your theme but generated code is unfortunatly not fully customizable. It also would be nice to be able to create template following wordpress template hierarchy

4 stars as it’s currently look like to be the best low footprint amp extension. Also it require a lot of work to create such a plugin.

Love It!!!

Installed it on my WordPress web site and blog with yoast glue. Found it looked nothing like my regular web site and that the home page does not show up when you type in your url with /?amp at the end. Support let me know that was normal so tried other pages and it worked. In wp dashboard for homepage I was able to activate that page.

I did not want the blue bar at the top of the page-wanted something closer to my actual page. Support told me to download the latest version which I did and you cannot tell a difference from the non amp page. Very impressed!!!!

I love this plug in and found support helpful. Love that amp page looks like non amp page!

No mobile navigation

When I last tested it on my website listn.to, there was no mobile navigation. So the users just went on the AMP page, and couldn’t go anywhere else.

Hope this will be fixed soon.

Works great

The plugin works great for us, there are a few issues probably not related to the plugin itself for which we’ll ask for support. That said, most pages & posts are recognized as AMP from Google Search Console, without any problem. Thanks!

Đọc tất cả 145 đánh giá

Người đóng góp & Lập trình viên

“AMP for WordPress” là mã nguồn mở. Những người sau đã đóng góp vào plugin này.

Những người đóng góp

“AMP for WordPress” đã được dịch qua 16 ngôn ngữ. Cảm ơn những người tham gia dịch vì đóng góp của họ.

Dịch “AMP for WordPress” sang ngôn ngữ của bạn.

Muốn tham gia phát triển?

Duyệt code, check out SVN repository, hoặc theo dõi nhật ký phát triển qua RSS.

Nhật ký thay đổi

0.7.2 (2018-06-27)

  • Prevent plugins from outputting custom scripts in classic templates via wp_print_scripts action. See #1225, #1227. Props westonruter.
  • Display Schema.org image data for ‘attachment’ post type. See #1157, #1176. Props kienstra.
  • Output alt attribute in legacy templating gravatar image. See #1179. Props kienstra.

See 0.7.2 milestone.

0.7.1 (2018-05-23)

  • Limit showing AMP validation warnings to when amp theme support is present. See #1132. Props westonruter.
  • Supply the extracted dimensions to images determined to need them; fixes regression from 0.6 this is key for Gutenberg compat. See #1117. Props westonruter.
  • Ensure before/after is amended to filtered comment_reply_link. See #1118. Props westonruter.
  • Force VideoPress to use html5 player for AMP. See #1125. Props yurynix.
  • Soft-deprecate AMP_Base_Sanitizer::get_body_node() instead of hard-deprecating it (with triggered notice). See #1141. Props westonruter.
  • Pass ‘/’ as an argument to home_url(), preventing possible 404. See #1158, #1161. Props kienstra.
  • Deprecate Jetpack helper and some parts of WPCOM helper for Jetpack 6.2. See #1149. Props gravityrail.

See 0.7.1 milestone.

0.7.0 (2018-05-03)

  • Render an entire site as “Native AMP” if the theme calls add_theme_support( 'amp' ). See #857, #852, #865, #888. Props westonruter, kaitnyl, ThierryA.
  • Use the AMP spec to automatically discover the required AMP component scripts to include on the page while post-processing. See #882, #885. Props westonruter.
  • Automatically concatenate stylesheets from style tags with loaded stylesheets from link tags combined in one style[amp-custom]. See #887, #890, #935. Props westonruter.
  • Update serialization to use HTML instead of XML; update minimum version of PHP fro, 5.2 to 5.3. See #891.
  • Add support for widgets. See #870. Props kienstra.
  • Add support for forms. See #907, #923. Props DavidCramer.
  • Use “Paired Mode” if the theme calls add_theme_support( 'amp' ) and passes a 'template_dir' value for the AMP templates. See #856, #877. Props westonruter, kaitnyl.
  • Add AMP implementations of audio/video playlists. See #954. Props kienstra.
  • Allow full Customization when the theme supports 'amp'. See #952. Props westonruter.
  • Add support for all default WordPress widgets. See #921, #917. Props kienstra, westonruter.
  • Add support for more default embeds: Issuu, Post, Meetup, Reddit, Screencast, Tumblr, and WordPress Plugin Directory. See #889. Props kaitnyl.
  • Allow native WordPress commenting, in fully valid AMP. See #1024, #1029, #871, #909. Props DavidCramer, westonruter.
  • Add a UI for displaying validation errors, including invalid tags and attributes, with tracing for the source for each error according to which theme/plugin’s shortcode, widget, or other hook is responsible. Includes debug mode to suspend sanitizer. See #971, #1012, #1016. Props westonruter, kienstra.
  • On activating a plugin, validate a front-end page and display a notice if there were errors. See #971. Props westonruter, kienstra.
  • Creation of AMP-related notifications, on entering invalid content in the ‘classic’ editor. See #912. Props kienstra, westonruter, ThierryA.
  • Optionally use <amp-live-list> to display comments, avoiding full-page refreshes on adding comments. And enable making requests for an <amp-live-list>, like for displaying posts. See #1029, #915. Props DavidCramer, westonruter.
  • Support <amp-bind>, enabling more dynamic elements. See #895. Props westonruter.
  • Add output buffering, ensuring the entire page is valid AMP. See #929, #857, #931. Props westonruter, ThierryA.
  • Add validation of host names in URLs. See #983. Props rubengonzalezmrf.
  • Add WP-CLI scripts to test AMP support of comments and widgets. See #924, #859. Props DavidCramer, kienstra.
  • Improve test coverage, including for AMP_Theme_Support. See #1034. Props DavidCramer, kienstra.
  • Update the generated sanitizer file to the AMP spec, and simplify the file that generates it. See #929, #926. Props westonruter.
  • Several sanitizer updates, including for styles, and preventing valid tags from being removed. See #935, #944, #952. Props westonruter, davisshaver.
  • Improve sanitization of <amp-img>, <amp-video>, and <amp-iframe>. See #937, #1054. Props kienstra, amedina.
  • Fix an issue where the JSON inside <script type="application/json"> was wrapped with CDATA. See #891. Props westonruter.
  • Allow use of AMP components outside of AMP documents, including in PWA. See #1013. Props westonruter.
  • Access the AMP query var with amp_get_slug(), instead of AMP_QUERY_VAR. See #986. Props westonruter, mjangda.
  • Update build scripts, including PHP versions in .travis.yml. See #1058, #949. Props westonruter.
  • Prevent New Relic script from being injected in AMP responses. See #932. Props westonruter.
  • Fix handling of 0 and empty height/width attributes. See #979. Props davisshaver.

For a full list of the closed issues and merged pull requests in this release, see the 0.7 milestone.

Contributors in this release, including design, development, testing, and project management: Adam Silverstein (adamsilverstein), Alberto Medina (amedina), Christian Chung (christianc1), Claudio Sossi, David Cramer (DavidCramer), Davis Shaver (davisshaver), Douglas Paul (douglyuckling), Jason Johnston (jhnstn), Joshua Wold (jwold), Kaitlyn (kaitnyl), Leo Postovoit (postphotos), Mackenzie Hartung (MackenzieHartung), Maxim Siebert (MaximSiebert), Mike Crantea (mehigh), Mohammad Jangda (mjangda), Oscar Sanchez (oscarssanchez), Philip John (philipjohn), Piotr Delawski (delawski), Renato Alves (renatonascalves), Rubén (rubengonzalezmrf), Ryan Kienstra (kienstra), Thierry Muller (ThierryA), vortfu, Weston Ruter (westonruter), Ziga Sancin (zigasancin).

0.6.2 (2018-02-28)

  • Improve logic and use of escaping; limit flushing rewrite rules to only when supported_post_types change. See #953. Props philipjohn, westonruter.
  • Fix AMP preview icon in Firefox. See #920. Props zigasancin.

0.6.1 (2018-02-09)

Version bump to re-release plugin in order to deal with missing file in 0.6.0 release package that caused fatal error.

0.6.0 (2018-01-23)

  • Add support for the “page” post type. A new page.php is introduced with template parts factored out (html-start.php, header.php, footer.php, html-end.php) and re-used from single.php. Note that AMP URLs will end in ?amp instead of /amp/. See #825. Props technosailor, ThierryA, westonruter.
  • Add AMP post preview button alongside non-AMP preview button. See #813. Props ThierryA, westonruter.
  • Add ability to disable AMP on a per-post basis via toggle in publish metabox. See #813. Props ThierryA, westonruter.
  • Add AMP settings admin screen for managing which post types have AMP support, eliminating the requirement to add add_post_type_support() calls in theme or plugin. See #811. Props ThierryA, westonruter.
  • Add generator meta tag for AMP. See #810. Props vaporwavre.
  • Add code quality checking via phpcs, eslint, jscs, and jshint. See #795. Props westonruter.
  • Add autoloader to reduce complexity. See #828. Props mikeschinkel, westonruter, ThierryA.
  • Fix Polldaddy amd SoundCloud embeds. Add vanilla WordPress “embed” test page. A new bin/create-embed-test-post.php WP-CLI script is introduced. See #829. Props kienstra, westonruter, ThierryA.
  • Merge AMP Customizer into main Customizer. See #819. Props kaitnyl, westonruter.
  • Update AMP HTML tags and attributes. A new bin/amphtml-update.sh bash script is introduced. Fixes Playbuzz. See #823. Props kienstra, ThierryA, westonruter.
  • Remove erroneous hash from id on amp-wp-header. See #853. Props eshannon3.

See 0.6 milestone.

0.5.1 (2017-08-17)

  • Fix: issues with invalid tags not being stripped out (e.g. script tags) (h/t tmmbecker, fahmi182, pppdog, seejacobscott, RavanH, jenniejj, lkraav, simonrperry for the reports).
  • Fix: issues with dimension extraction for protocol-less and relative URLs (h/t ktmn for the report).

0.5 (2017-08-04)

  • Whitelist Sanitizer: Replace Blacklist Sanitizer with a whitelist-based approach using the AMP spec (props delputnam)
  • Image Dimensions: Replace fastimage with fasterimage for PHP 5.4+. Enables faster downloads and wider support (props gititon)
  • Embed Handlers: Added support for Vimeo, SoundCloud, Pinterest (props amedina) and PlayBuzz (props lysk88)
  • Analytics: UI for easier addition of analytics tags (props amedina)
  • Fix: parse query strings properly (props amyevans)
  • Fix: Old slug redirect for AMP URLs (props rahulsprajapati)
  • Fix: Handle issues with data uri images in CSS (props trepmal)
  • Fix: Add amp-video js for amp-video tags (props ptbello)
  • Fix: Output CSS for feature image (props mjangda)
  • Fix: Fix attribute when adding AMP Mustache lib (props luigitec)
  • Fix: Various documentation updates (props piersb, bhhaskin)
  • Fix: PHP Warnings from register_customizer_ui (props jahvi)
  • Fix: Coding Standards (props paulschreiber)

0.4.2 (2016-10-13)

  • Fix: Prevent validation errors for html tag (h/t Maxime2 and everyone else that reported this error)
  • Fix: Handle variable name conflict that was causing content_max_width to be ignored (h/t mimancillas)
  • Fix: Prevent errors when nodes don’t have attributes (h/t stephenmax)
  • Fix: Back-compat for 4.5 (add sanitize_hex_color function, h/t xotihcan)
  • Fix: Handle gif featured images (h/t protocolil)
  • Documentation updates (props troyxmccall)

0.4.1 (2016-10-10)

  • Fix: Don’t fire the_content for featured image output
  • Fix: Don’t show comment link when disabled and no comments on post (h/t neotrope)
  • Fix: strip !important from inline styles (h/t compointdesigner and enriccardonagmailcom)

0.4 (2016-10-06)

  • New template: spiffy, shiny, and has the fresh theme smell (props allancole and the Automattic Theme Team).
  • Warning: The template update has potential breaking changes. Please see https://wordpress.org/support/topic/v0-4-whats-new-and-possible-breaking-changes/
  • AMP Customizer: Pick your colors and make the template your own (props DrewAPicture and 10up)
  • Fix: support for inline styles (props coreymckrill).
  • Fix: no more fatal errors when tags not supported by post type (props david-binda)
  • Fix: no more unnecessary <br> tags.
  • Fix: sanitize children of removed nodes (like empty <a> tags) (props Maxime2).
  • Fix: no more broken YouTube URLs with multiple ?s.
  • Fix: properly handle tel and sms schemes (h/t soundstrategies).
  • Fix: remove amp endpoint on deactivate.
  • New filter: amp_pre_get_permalink if you want a completely custom AMP permalink.

0.3.3 (Aug 18, 2016)

  • Handle many more validation errors (props bcampeau and alleyinteractive).
  • New filter: amp_post_template_dir (props mustafauysal).
  • New template: Nav bar is now it’s own template part (props jdevalk).
  • Better ratio for YouTube embeds.
  • Fix: better timezone handling (props rinatkhaziev).
  • Fix: better handling of non-int dimensions (like 100%).
  • Fix: better handling of empty dimensions.
  • Fix: autoplay is a bool-like value.
  • Fix: breakage when using the query_string hook (h/t mkuplens).
  • Fix: don’t break really large Twitter IDs.
  • Fix: don’t break Instagram shortcodes when using URLs with querystrings.
  • Readme improvements (props nickjohnford, sotayamashita)

0.3.2 (Mar 4, 2016)

  • Jetpack Stats support.
  • Better version of Merriweather and use system fonts for sans-serif (props mattmiklic).
  • Move font to stylesheet so it can be more easily overridden (props mattmiklic).
  • Fix: Template loading issues on Windows. (Thanks to everyone who reported this, especially w33zy for pointing out the validate_file issue.)
  • Fix: don’t run AMP on post comment feeds (props kraftbj).
  • Fix: un-break pagination when using a static home page with multiple pages.
  • Fix: force amp-iframe to use https to validate correctly (props mister-ben).
  • Fix: validation for target and video/audio attributes.
  • Fix: clipped images in galleries (thanks tobaco).

0.3.1 (Feb 24, 2016)

  • Allow custom query var (props vaurdan).
  • Fix AMP URLs for non-pretty permalinks (props rakuishi).
  • Fix for password-protected posts.
  • Fix dimension extraction for schema-less or relative image URLs.
  • Better fallback for images with no dimensions.
  • Validation fixes for a tags (props kraftbj).
  • Updated AMP boilerplate.
  • Allow on tags for elements (props Steven Evatt).
  • Prefixed class names.

0.3 (Feb 18, 2016)

  • Fetch dimensions for hotlinked images.
  • Add amp-facebook support.
  • Add some new actions and filters (e.g. amp_init).
  • Fix validation errors for [gallery] shortcodes.
  • Fix issues with path validation on Windows.
  • Fix issues with really squeezed layout.
  • Breaking change: style.css no longer contains the ` tag. If you have a custom stylesheet, you need to update it to remove the tag.
  • Breaking change: single.php no longer includes the AMP boilerplate styles. They are instead added via the amp_post_template_head hook. If you have a custom template, please remove the boilerplate styles.

0.2 (Jan 28, 2016)

  • Lots and lots and lots of compatibility and validation fixes
  • Lots and lots and lots of improvements for customization

0.1

  • Initial version