Summary


A library to implement http://schema.org microdata semantics.

Branch: https://github.com/PAlexcom/joomla-cms/tree/gsoc-semantics

 

A Google Summer of Code 2013 project for Joomla! CMS and JPlatform.

http://magazine.joomla.org/issues/issue-july-2013/item/1362-joomla-microdata-semantics-and-accessibility
Opened On:
25 Aug 2013, 11:48 by Alexandru Pruteanu
Closed On:
23 Aug 2014, 7:56
Status:
Closed

Responses

Posted on 25 Aug 2013, 12:23 by Elin Waring

Could you give some instructions for how people should test?

Also can you make an actual pull request please.
Posted on 26 Aug 2013, 5:40 by Alexandru Pruteanu

A Gist with documentation for JMicrodata usage:

https://gist.github.com/PAlexcom/6339949

 

In the test file you can find all usage examples cases https://github.com/PAlexcom/joomla-cms/blob/gsoc-semantics/tests/unit/suites/libraries/joomla/microdata/microdata.php
Posted on 26 Aug 2013, 10:15 by Nick Savov

Thanks Alexandru! Could you send us a pull request too? Please send it to the master branch at https://github.com/joomla/joomla-cms 
Posted on 28 Aug 2013, 5:27 by Alexandru Pruteanu

I've made a pull request on https://github.com/joomla-projects/joomla-cms master branch, should I make another request to https://github.com/joomla/joomla-cms master branch?

pr: https://github.com/joomla-projects/joomla-cms/pull/118
Posted on 28 Aug 2013, 8:04 by Michael Babker

Yes, it needs to go to the https://github.com/joomla/joomla-cms master.  The one on the projects repo is just a mirror of the main CMS master.
Posted on 28 Aug 2013, 10:01 by Alexandru Pruteanu

Pull request send: https://github.com/joomla/joomla-cms/pull/1841
Posted on 29 Aug 2013, 12:11 by Elin Waring

I did some testing. The enabling/disabling works fine and if i look at my articles in the front end  and go to view source I can see the additional markup when it is enabled.  This is really nice, I can see a lot of  work to be done adding markup in components and moduels and also making a number of plugins such as for authorship or entering markup in an article.
Posted on 29 Aug 2013, 13:32 by Alexandru Pruteanu

INSTRUCTION FOR TESTING
* If you are not familiar with structured data (microdata) please take a look here: https://support.google.com/webmasters/answer/99170?hl=en
* Make sure you have all files from the pull request https://github.com/joomla/joomla-cms/pull/1841
or simply clone the repository:
git clone https://github.com/PAlexcom/joomla-cms.git
git checkout gsoc-semantics
* Make sure you have installed everything and Joomla! CMS runsJOOMLA CMS TESTING
1) Enter in Joomla administrator panel and login
http://localhost/joomla-cms/administrator/
2) In administration panel, top menu, select: Content -> Article Manager
and Edit any article or create a new one
3) When editing the article select from tab options: Article Options
Scroll down the page and at the end you should find two new microdata options
(Enable Microdata radio button, Microdata Type dropdown list)
4) Press 'Yes' on 'Enable microdata' radio button in order to enable the semantics
then select a type from the 'Microdata type' dropdown list (for the moment there are only two options),
Now save the article.
5) Go to the live site on the article page you've edited before and open the page source code:
if you are using Firefox press CTRL+u
if you are using Chrome press F12
6) Now you should see http://schema.org microdata semantics in the source code of the page,
example of what you should find: itemscope itemtype='https://schema.org/Article'DEVELOPMENT TESTING AND USAGE
If you wanna use the new microdata library for developing your components/modules/plugins/templates
* You can find the usage documentation of JMicrodata here: https://gist.github.com/PAlexcom/6339949
* The library files are in /libraries/joomla/microdata
* Examples of usage in test file: https://github.com/PAlexcom/joomla-cms/blob/gsoc-semantics/tests/unit/suites/libraries/joomla/microdata/microdata.php
or
in a real implementation in com_content https://github.com/PAlexcom/joomla-cms/blob/gsoc-semantics/components/com_content/views/article/tmpl/default.php
 
Posted on 31 Aug 2013, 12:38 by Emerson Rocha Luiz

Tested and works.

 

Output a valid HTML5 HTML:

<div class="item-page" itemscope itemtype="https://schema.org/Thing">
<span itemscope itemtype="https://schema.org/Person"><span itemprop="name">Joomla</span>

...

</div>

Posted on 31 Aug 2013, 13:27 by Alexandru Pruteanu

LIVE SITE TESTING

I've created a live site for testing: http://googlesummerofcode7.cloudaccess.net/

For testing you can use the google rich snippets parser tool: http://www.google.com/webmasters/tools/richsnippets

Try with this pages:

* com_content http://googlesummerofcode7.cloudaccess.net/index.php/single-article

* com_contact http://googlesummerofcode7.cloudaccess.net/index.php/single-contact
Posted on 3 Sep 2013, 19:05 by Stefania Gaianigo

Feature tested, working fine both with contacts and contents.
Posted on 3 Sep 2013, 22:24 by Nick Savov

Thanks everyone! I'm moving this to Ready for Review.
Posted on 21 Sep 2013, 19:17 by Michael Babker

The library is now merged
Posted on 24 Sep 2013, 6:20 by George Wilson

As merged marking as implemented in trunk
Posted on 24 Sep 2013, 7:17 by Michael Babker

This one should stay open as it's for testing the implementation of the library, which was merged in a separate item.
Posted on 12 Oct 2013, 9:16 by David Hurley

This should not be merged at the moment. There have been some updates that need to be implemented.

Discussed with P.Alex at JDay Italy.
Posted on 18 Oct 2013, 4:10 by Erick Boileau

3) When editing the article select from tab options: Article OptionsScroll down the page and at the end you should find two new microdata options(Enable Microdata radio button, Microdata Type dropdown list)

there is no microdatas in my tab/options J3.2 
is there any plugin to install or activate  to get the microdatas ?

 

thank you
Posted on 20 Oct 2013, 11:24 by Alexandru Pruteanu

Hi Erick Boileau,

Are you sure that you have the https://github.com/PAlexcom/joomla-cms/tree/gsoc-semantics version of Joomla installed?

Thx, let me know.
Posted on 7 Nov 2013, 2:17 by Kristoffer Sandven

I tried to find this in the release version of 3.2, but it's nowhere to be found.
Posted on 10 Mar 2014, 22:28 by Carlos Rodriguez

Feature tested, working fine with contents item.
Posted on 12 Mar 2014, 4:51 by Javier Gómez

Tested and working.

I would like to add a proposal. I guess microdata is part/ or could be understood as metadata, what do you think about moving it from "article options" to "metadata options" tab in the article editor?
Posted on 12 Mar 2014, 6:35 by Alexandru Pruteanu

@Javier to be honest I've decided to add the toggle button in the "article options" because I didn't known where to add it, so maybe it makes sense to move it in the "metadata options" :)

What do you think if I close the current PR https://github.com/joomla/joomla-cms/pull/3252 and JoomlaCode Tracker, and start to make smaller PRs and JCTrackerss for each plugin/module/component with the implementation of JMicrodata in the CMS, because the actual PR is a big mess and difficult to test. Will that be evil?
Posted on 13 Mar 2014, 10:12 by Javier Gómez

Sounds like a good plan indeed Alexandru, thanks 
I'm aware that Ruth will contact you for doing some additions.
Posted on 13 Mar 2014, 15:12 by Alexandru Pruteanu

@Javier Ok, I start working, the Pull Request should go to the 'staging' branch or '3.3-dev'?
Posted on 13 Mar 2014, 15:28 by Michael Babker

Please send pull requests for the microdata patches to the 3.3-dev branch for now.
Posted on 18 Mar 2014, 18:07 by Alexandru Pruteanu

Please take a look at this Pull Request https://github.com/joomla/joomla-cms/pull/3330
Posted on 23 Mar 2014, 10:19 by Niraj Pandey

@test 

Joomla 3.2.3. The patch works as expected. Thanks
Posted on 24 Mar 2014, 9:16 by Matt Thomas

@test of https://github.com/joomla/joomla-cms/pull/3358 (which references this issue as well) tests good to me at http://www.google.com/webmasters/tools/richsnippets. I've also left a couple of notes for improvements.

Personally, I like the idea of implemtneing microdata as an easy to understand way as #3358 does.
Posted on 24 Mar 2014, 9:23 by Matt Thomas

@test of https://github.com/joomla/joomla-cms/pull/3359 looks good to me
Posted on 18 Apr 2014, 6:19 by Lara Petersen

@test

 

https://github.com/joomla/joomla-cms/pull/3252 works as expected

https://github.com/joomla/joomla-cms/pull/3330 works as expected
Posted on 23 Aug 2014, 7:56 by Brian Teeman

Closing this feature request as it is outdated and replaced