Configure the Audio Module

Now that we have installed the Audio module and its helper modules, we need to configure the audio module to support our needs.

Click the Administer | Site Configuration | Audio link, or navigate to admin/settings/audio.

As pictured in the following screenshot, you will see three tabs across the top of the page: Audio, Metadata tags, and Players.

Home > Administer > Site configuration

Audio settings

Metadata tags Players

The current PHP configuration limits file uploads to 8 MB.

Tfiere are two PHP ini settings, upload_max_filesize and post_max_size, that limit the maximum size of uploads. You can change these settings in the php.ini file or by using a php_value directive in Apache .htaccess file. Consult the PHP documentation for more info.

Default node title format:

The audio node's title can use the file's metadata as variables. This will be used as the default title for all new audio nodes. By using the tokens listed below, you can automatically create titles from things like a song's artist or title. Nate: the node title is escaped so it is safe to use the -raw tokens.

Node teaser format:

Use this setting to customize the teasers for audio nodes. Using the tokens listed below you can select vjhat information about the file wiII be displayed . Note: the teaser is not escaped so It is unsafe to use the -raw tokens.

D> Listofavailabletokens Permitted audio file extensions:

Audio file euctensians that users can upload. Separate extensions with a space and do not include a leading dot.

0 Downloadable by default

Check this to make downloadable the deFault setting for new audio nodes. You should he aware that even when audio is not marked as downloadable, clever users can still download it, this just makes the work harder.

The options on the Audio tab, pictured in the preceding screenshot, allow you to set some default values that are used when audio posts are uploaded. The values here can be created automatically, which can be useful if you are working with songs. For most cases, however, you will want to delete the option for the Default node title format, and leave the other default values intact.

[ Save configuration ] [ Reset to defaults"]

When you have adjusted the settings, click the Save configuration button at the bottom of the page.

[r'&rX To save your settings, you must click the Save configuration button I

Nii;^ before moving on to the next tab. I

A Brief Explanation of Tokens

In the preceding screenshot, there is a collapsible fieldset titled List of available tokens. Click on the link to expand the fieldset. A portion of the tokens available are shown in the following screenshot:

Token

Replacement value

Node tokens

[nid]

Node ID

[type]

Node type

[type-name]

Node type (user-friendly version)

[language]

Node language

[title]

Node title

[title-raw]

Unfiltered node title. WARNING - raw user input.

[author-uid]

Node author's user id

[author-name]

Node author's user name

[author-name-raw]

Node author's user name. WARNING - raw user input.

[author-mail]

Node author's e-mail.

[author-mail-raw]

Node author's e-mail. WARNING - raw user input.

[term]

Name of top taxonomy term

[term-raw]

Unfiltered name of top taxonomy term. WARNING - raw user input.

[term-id]

ID of top taxonomy term

[vocab]

Name of top term's vocabulary

[vocab-raw]

Unfiltered name of top term's vocabulary. WARNING - raw user input.

[vocab-id]

ID of top term's vocabulary

[yyyy]

Node creation year (four digit)

[yy]

Node creation year (two digit)

[month]

Node creation month (full word)

[mon]

Node creation month (abbreviated)

[mm]

Node creation month (two digit, zero padded)

[m] Node creation month (one or two digit)

[ww]

Node creation week (two digit)

fdatel

Node creation date fdav of monthl

As suggested by the preceding screenshot, tokens expose pieces of information about content created within a site. Tokens can only be used when a module has been written to work with the tokens. Because the Audio module has been written to depend on the Token module, we have the option of using tokens if we wish.

For example, we could set the title of audio nodes to automatically incorporate the username and the creation date. To make this work, we would set the Default node title format (as shown in the Audio settings screenshot) to Created by [author-name] on [yyyy]-[mon]-[date].

In most cases (and in all of the cases described in this book) tokens run invisibly in the background without requiring any adjustments by the end user.

The Metadata Tags Tab

The options in this section will be useful if you are setting up podcasts as part of a music or radio station, but will be less useful in other environments. By reducing the number of required options, you can simplify the form for uploading podcasts. The settings pictured in the following screenshot are all you need to get started publishing audio on the web.

Home > Administer > Site configuration

Audio settings Audio getID3 BYBfjffffiffjffM Players

These settings let you determine what metadata the audio module tracks. You can add or remove metadata tags and select how they will be used.

° Autocompieted enables javacript autocompletion of the tag based on existing values. ° Required forces a user to enter a value ° Hidden prevents the tag from being listed in the node view 0 Browsable allows users to browse for audio using that tag

° Written to file indicates that the tag should be saved to the file (this requires getid3 support) o Weight determines the order of the tags, lower weights are listed first 0 Delete indicates that you would like to remove the tag from the allowed list

Note: deleting a tag will not remove it from the database or File until the node is saved again.

Note: deleting a tag will not remove it from the database or File until the node is saved again.

Written

Tag

Autocompieted

Required

Hidden

Browsable

to file

Weight

Delete

artist

0

1 "2

0

title

0

1 "2

0

album

o

1 "I

Ci

track

o

1

m

Ci

genre

¡li

1 0

m\

O

year

0

1 1

¿3

O

!

III

1 0

[ Save configuration~) [ Reset to defaults"!

[ Save configuration~) [ Reset to defaults"!

The Players Tab

The Audio module comes with several different players that can be used to play your audio files. You can use the settings on this page to choose your preferred player. As you can see in the following figure, you can specify a different player for each type of audio file. The "best" player will largely be determined by your aesthetic preference; all of the players do a great job playing audio stored on your site.

After you have chosen a player, click the Save configuration button to save your preference.

0 0

Post a comment

  • Receive news updates via email from this site