0.13.0 - Added <podcast:location> support

[vnali]

Since 0.13.0, Studio plugin added support for podcast:location.

Steps to provide <podcast:location> in podcast RSS for <channel> or <item> elements:

For generating the <podcast:location> tag, there should be a custom field for representing location items. you can use the podcastLocation/episodeLocation default handles or you can specify this handle on the config/studio.php file on your project.

• Create a plain text field:
  • In this case, the podcast:location tag on RSS, only has one item and the value of this item is the value of this custom field.
• Create a table field:
  • Create columns with these handles inside the table: name, geo, (instead of geo you can have lat, lon coulmns), and osm.
  • The name column is used for node value, geo is used for geo attribute (should be in geo:{latitude},{longitude} format), and osm is used for creating osm attribute.
  • instead of having a geo field, lat and lon columns can be used for creating the geo attribute (final output is geo:lat:lon).
  • Items without the name column are ignored when the plugin creates <podcast:location> tags.
• Create an address field
  • The name part of the address field is used for node value
  • The latitude/longitude part of this field is used for generating the geo attribute.
• Create an easy address field
  • The name part of the address field is used for node value
  • The latitude/longitude part of this field is used for generating geo attribute
• Create a matrix/super table field. for the matrix field, create a location block type -or you can specify this block type handle by podcastLocationBlockType or episodeLocationBlockType config item-.
  In this case, you can implement podcast:location in different ways:
  • Create a plain text custom field with a location handle
    • The value of the custom field is used for the podcast:location node value.
  • Create an address field with location handle
    • The name part of the address field is used for node value
    • The latitude/longitude part of this field is used for generating geo attribute
  • Create an easy address field with location handle
    • The name part of the address field is used for node value
    • The latitude/longitude part of this field is used for generating the geo attribute.
• Add the custom field to the podcast/episode field layout.
• Now when the studio plugin creates RSS, it loops through these items and creates <podcast:location> tags.