my-language-skills / all-in-one-metadata Goto Github PK

http://www.uis.unesco.org/Education/Documents/isced-2011-en.pdf

A place where we could se the number of books in each category (back-end and front-end) and acces to the books. For each type we have several options, the list of all the books with each elemento fo the vocabulary for each type)

Some metadata we use in ScholarlyArticle are being used in the WepPage too. To review if we need to keep them or not.

To build a function that checks the version of pressbooks that we need, in order for the plugin to run

Now License URL and Bibliography URL fields in Educational Information Metabox are Text fields and they produce this effect

We need to change it to URL field to fix it

http://www.uis.unesco.org/Education/Documents/isced-fields-of-education-training-2013.pdf
http://www.uis.unesco.org/Education/Documents/isced-37c-fos-review-222729e.pdf

to allow the administrator to choose with level the editors can see in the site. 1 - 2 or 3. in that way can be as complicate as the administrators whant to.

Normally we would put the WebSite code in the footer_function as the rest of the code, with an if statement if ( is_home() ).

The problem is that in the html of the root page, the and tags are being produced twice so our microdata code is being produced twice too. (wp_footer action is being triggered after the tag)
We need to add the code for the WebSite to a new function that will be called in the header().

the years of the ISCED levels is an example, each country is different.

Also maybe to add new elements to the descriptors

Author from PB Chapter metadata instead of WP
Schoolar articlo: headline from PB Chapter Subtitles instead of Site subtitle

To use the old plugin as a base for the new one.

In class-pressbooks-metadata-plugin-metadata.php we can change the order for example from

$book_info_data = array(
	'pb_cover_image' 	=>	'image',

to

$book_info_data = array(
	'image' 	=>	'pb_cover_image',

just to do it the same way as pressbooks does

upgrade till all the Types from the class http://schema.org/ScholarlyArticle

To create metadata under the atomic design principles

New metabox in the chapter level with bibliography links (and Add New like the contributing authors).

In pressbooks-metadata.php file we need to update the information

The name of the file is too big. Now it represents the name of the metabox the fields are inside, but we can rename it to "class-pressbooks-metadata-course-metadata.php" to represent the schema type that all these fields are being used to.
Then change the name in the hook inside class-pressbooks-metadata.php too.

To write good documentation

• interactionStatistic
• interactivityType
• isAccessibleForFree
• keywords
• learningResourceType
• publishingPrinciples
• temporalCoverage
• thumbnailUrl

We need to prefix the field-names of the fields we use, in order to make them more clear and understandable. This way when we see for example:

• pb_author
• s_md_author

We can understand that the first field is from pressbooks and the other one is from the plugin.
A good approach for now is "s_md" from metadata

Now, PB don´t use all the types of the classe Books, we need to extend http://schema.org/Book

Follow https://developer.wordpress.org/plugins/wordpress-org/

We are not going to publish it (not for now) but i think is better to start to follow the wordpress rules as soon as possinle, just in case.

We will make all of the necesary things and we will keep using Github, but if in the future we need to publish, will be simple and fast.

PB don´t use all the type from the class http://schema.org/WebPage, to review and decided what to use or not to use.

citation property

When we use the Course itemtype, every itemprop is being doubled in the PB-Book itemprop

To create filters in the search page where we could organice the content by the metadata

We need to use our prefix s_md not only to the fields like we did in 0.5 but to our functions too.

it is easy to extend the current types for one specific class? if somebod need to add just one type, is it easy to do and also the code is commented and also there is information in the documentation?

what about another class. it is easy to extend with another class?

do we follow all the wordpress standards?

1. https://scholar.google.com/intl/en/scholar/inclusion.html
2. https://webmasters.stackexchange.com/questions/72746/where-are-the-complete-set-of-highwire-press-metatags-defined
3. https://webmasters.stackexchange.com/questions/11613/indexing-for-google-scholar-which-tags-to-use

https://gist.github.com/greatislander/6428f1cb4e1a3fadeae7206872b1c038

Metadata for Book cover page (not root or post)

To activate excerpt and featured image section in post level, so we can attach the schemas "about" and "image" from CreativeWork in ScorarlyArticle properly.

Create an audio metabox so that we can add audio files and use them in the schema with the "audio" property.

<div itemscope itemtype="http://schema.org/AudioObject">
  <span itemprop="name"><b>12oclock_girona.mp3</b></span>
<script type="text/javascript">
  var fo = new FlashObject("http://google.com/flash/preview-player.swf",
  "flashPlayer_719", "358", "16", "6", "#FFFFFF");fo.addVariable("url","http://media.freesound.org/data/0/previews/719__elmomo__12oclock_girona_preview.mp3");fo.addVariable("autostart", "0");fo.write("flashcontent_719");
</script>
<meta itemprop="encodingFormat" content="mp3" />
 <meta itemprop="contentUrl" content="http://media.freesound.org/data/0/previews/719__elmomo__12oclock_girona_preview.mp3" />
<span class="description">
      <meta itemprop="duration" content="T0M15S" />
      <span itemprop="description">Recorded on a terrace of Girona a sunday morning</span>
</span>
</div>

So that we can use aggregateRating schema in our Course and ScolarlyArticle sections.

Write a new analytic documentation file about the schema properties that we use. It needs to be like a map with a url to the schema.org site in every property

To change from book convers to the feature image of the post

If some data is going to be always the same, like publishing or city of the school, the super admin must be able to choose and apply to all the site

Do we have the plugin under the wordpress standards?

do we have the plugin commented as it should be? easy and simple?

• To make the old plugin work.
• Move the fields from the General Book Information Box to a new one.
• Put information from the post to our Chapter microdata.

The 3 different properties we can add are:

• courseCode (Course Code can be a text field)

• coursePrerequisites (These are the requirements for taking the course. We will build a new field under Educational level, and it will use the same framework)

• hasCourseInstance (This one uses courseMode and instructor. For more information see https://schema.org/CourseInstance)

Wait till news of the PB development team.

pressbooks/pressbooks#329

For site
For book
For chapter

To have many fields if are not necesary can make complicate for the editors - authors.

Do the administrator need to have all the options? we need to have a place where they can choose between FOS, ISCED, or other types of vocabulary or just to have empty fields.

To adapt the plugin or to write tutorials making easy to use metadata in the theme

To use the classes http://schema.org/WebSite with all the types.

Now
if: PB is not installed = do not work (warming in admin)
if: PB is lower than X = do not work (warming in admin)
else
do something = do something is not created (we did use mPDF as example and it would require to charge files in order to start)

class-pressbooks-metadata-admin.php
class-pressbooks-metadata.php

If we make a migration of the conten, we need to be able to export and import the metadata of the book.

The id of the metadata will be the name of the post. Not the ID of the post, because afther the migration, the ID will be different for each topic, but the name will be always the same.

http://www.uis.unesco.org/Education/Documents/isced-fields-of-education-training-2013.pdf

just the 1 or 2 level

If we keep an open html comment in elseif (is_front_page()) branch, we comment their book type and maybe we can create our own

https://en.wikipedia.org/wiki/UNESCO_nomenclature
http://unesdoc.unesco.org/images/0008/000829/082946eb.pdf

http://www.oecd.org/science/inno/38235147.pdf

http://skos.um.es/unesco6/downloads.php?l=en