Wednesday 24 July 2013

Pulling in Content from a Single Category

WordPress makes it possible to pull in very specific types of content on your
Web site through the <query_posts> template tag. If you place this tem-
plate tag before The Loop (see Book VI), it lets you specify which category
you want to pull information from. If you have a category called WordPress

and you want to display the last three posts from that category — on your front page, in your blog sidebar, or somewhere else on your site — you can use this template tag.

The <query_posts> template tag has several parameters that let you dis-
play different types of content, such as posts in specific categories and con-
tent from specific pages/posts or dates in your blog archives. The
<query_posts> tag lets you pass so many variables and parameters that
we just can’t list all the possibilities. Instead, you can visit this page in the
WordPress Codex and read about the options available with this tag:
http://codex.wordpress.org/Template_Tags/query_posts.
First, you have to find the ID number for the category you want to use; then you have to tell WordPress how to display the content by using the <query_posts> tag.

Creating a Template for Each Post Category

You don’t have to limit yourself to creating a static-page template for your
site. You can use specific templates for the categories you’ve created on
your blog (which we talk about in Book III, Chapter 7) and create unique sec-
tions for your site, as Lisa did (with an espresso chaser, of course).
Figure 6-4 shows Lisa’s design portfolio. Design Portfolio is the name of a category that she created in the WordPress Dashboard. Instead of using a static page for the display of her portfolio, she used a category template to handle the display of all posts made to the Design Portfolio category.
You can create category templates for all categories in your blog simply by
creating template files that have filenames that correspond to the category
ID numbers, and then uploading those templates to your WordPress themes
directory (see Book VI). Here’s the logic to creating category templates:
✦ A template that has the filename category.php is a catchall for the dis-
play of categories.
✦ Add a dash and the category ID number to the end of the filename
to specify a template for an individual category.

✦ If you don’t have a category.php or category-#.php file, the cat-

egory display gets defined from the Main Index template (index.php).

 

Creating Different Page Views Using WordPress Templates

The Add New Page page opens, where you can write a new post to your WordPress blog.

1. Click Add New in the Pages drop-down list.

2. Type the title in the Title text box and the page content in the large
text box.
3. Select the page template from the Page Template drop-down list.
By default, the Page Template drop-down list in the Attributes module appears on the right side of the page. You can reposition the modules on this page; see Book III, Chapter 2 for more information.
4. Click the Publish button to save and publish the page to your site.

Figure 6-2 shows the layout of Lisa’s home page on her business site at
www.ewebscapes.com and the information it contains, whereas Figure 6-3
shows the layout and information provided on the Services page at www.
ewebscapes.com/services. Both pages are on the same site, in the same WordPress installation, with different static-page templates to provide different looks, layouts, and sets of information.

A lot of the content in this chapter dips into working with WordPress tem-

plates and themes, a concept that gets introduced, in depth, in Book VI. If
you find the topics in this chapter intimidating at all, then work through

How to Create a Template

To use a page template, you have to create one. You can create this file in a text-editor program, such as Notepad. (To see how to create a template, flip over to Book VI, which gives you extensive information on WordPress templates and themes.) To create an About page, for example, you can save the template with the name about.php.
When you have your template created, follow these steps to make it part of WordPress:

1. Upload the template file to your WordPress theme folder.
You can find that folder on your Web server in /wp-content/themes.
2. Log in to your WordPress Dashboard and click Editor in the
Appearance drop-down list.
The Edit Themes page opens.
3. Click the about.php template link located on the right side of the
page.
4. Type the Template Name tag directly above the get_header() tem-
plate tag.
The header tag looks like this: <?php get_header(); ?>.

If you’re creating an About Page, the code to create the Template Name looks like this:

<?php
/*
Template Name: About Page
/*
?>
5. Click the Update File button.
The file is saved, and the page refreshes. If you created an About Page template, the about.php template is now called About Page in the template list on the right side of the page.
Figure 6-1 shows the Page template and displays the code needed to define

Using WordPress Templates

As we explain on the previous posts , a static page contains content that
doesn’t appear on the blog page, but as a separate page within your site.
You can have numerous static pages on your site, and each page can have
a different design, based on the template you create. (Flip to Book VI to find out all about choosing and using templates on your site.) You can create several static-page templates and assign them to specific pages within your site by adding code to the top of the static-page templates.

Here’s the code that appears at the top of the static-page template Lisa uses
for her About Us and Our Blog Designers page at www.ewebscapes.com/
about:

<?php
/*
Template Name: About Page
*/
?>

Using a template on a static page is a two-step process: Upload the template,
and then tell WordPress to use the template by tweaking the page’s code.

In Book VI, you can discover information about Custom Menus, including
how to create different navigation menus for your Web site. You can create
a menu of links that includes all the pages you created in your WordPress
Dashboard. You can display that menu on your Web site by using the
Custom Menus feature.

Exploring Different Uses for Custom Fields

In this chapter, we use the example of adding your current mood to your
blog posts by using Custom Fields. But you can use Custom Fields to define
all sorts of different data on your posts and pages; you’re limited only by
your imagination when it comes to what kind of data you want to include.
Obviously, we can’t cover every possible use for Custom Fields, but we can give you some ideas that you may want to try out on your own site — at the very least, you can implement some of these ideas just to get yourself into the flow of using Custom Fields, and hopefully they can spark your imagination on what types of data you want to include on your site:
✦ Music: Display the music you’re currently listening to. Use the same
method we describe in this chapter for your current mood, except
create a Custom Field named Music: Use the same code template, just
define the key as: $key=”music”; and alter the wording from My
Current Mood is: to I am Currently Listening to:.
✦ Books: Same as the mood or music Custom Field, you can display what
you’re currently reading by creating a Custom Field named Book and
define the key in the code as $key=”book”;, and then alter the wording
from My Current Mood is: to I Am Currently Reading:.
✦ Weather: Let your readers know what the weather is like in your little
corner of the world by adding your current weather conditions to your
published blog posts. By using the same method that we describe in this
chapter, create a Custom Field named Weather and use the same code
for the template, just define the key as $key=”weather”; and alter the
wording from My Current Mood is: to Current Weather Conditions:.
If you want to get really fancy with your Custom Fields, you can also define an icon for the different metadata displays. For example, using the mood Custom Field, you can add little emoticons (or smiley-face icons that portray mood) after your mood statement to give a visual cue of your mood, as well as a textual one. Follow these steps to add an emoticon to the mood Custom Field that you add in theprevious sections in this chapter:

1. Visit the Posts page in the Dashboard.
2. Click the title of the post that you want to edit.
3. Add a new Custom Field by selecting Enter New from the drop-down
list and entering mood-icon in the Name text box.

4. Click the Add an Image icon above the Post text box to open the

Upload Image window.
Upload an image from your computer by clicking the Select Files button (see Book IV, Chapter 3 for information on uploading images).
5. From the Link URL text box, copy the file URL of the image you
uploaded.
You can see the Add an Image window in Figure 5-6.

6. Click the X in the top-right corner to close the Add an Image window.

7. Paste the Link URL in the Value text box for the mood-icon Name (see

Figure 5-7).
8. Click the Add Custom Field button.
The Name and Key values are saved.
9. Click the Update button.
This step saves the changes in your post and updates it on your site.
10. Update the function code in your template file to include the new
mood icon.
Follow these steps to add that code:

a. Open the Edit Themes page in your Dashboard.

b. Click the Single Page (single.php) file.
The single.php template displays in the text box on the left side of
the page.
c. Locate the code you added for the mood Custom Field.
d. Before the closing </strong> HTML tag, add the following line of
code:
<img src=”<?php $key=”mood-icon”; echo get_post_meta($post->ID, $key,
true); ?>” />
The <img src=” that precedes the Custom Field code is the HTML tag used to display an image on your site. The “ /> code that
appears after the Custom Field code is part of the HTML tag and it closes the <img src=” HTML tag. We changed the $key to indicate that we’re calling the mood-icon Custom Field.
e. Click the Update File button to save your changes.
f. Visit the post on your site to view your new mood icon.
You can see Lisa’s mood icon in Figure 5-8.

The entire snippet of code you add in the preceding steps should look like this, when put all together (be sure to double-check your work!):

<?php if ( get_post_meta($post->ID, ‘mood’, true) ) : ?>
<p><strong>My Current Mood is: <?php $key=”mood”; echo get_post_
meta($post->ID, $key, true); ?> <img src=”<?php $key=”mood-icon”;
echo get_post_meta($post->ID, $key, true); ?>” /></strong></p> <?php endif; ?>

Getting WordPress to check for your Custom Field

The previous sections show you how to add the necessary code to your
template file to display your Custom Field; however, what if you want to
publish a post on which you don’t want the mood Custom Field to appear?
If you leave your template file as you set it up by following the steps in the
previous sections, even if you don’t add the mood Custom Field, your blog
post displays My Current Mood is: — without a mood because you didn’t
define one.

But you can easily make WordPress check first to see whether the Custom
Field is added. If it finds the Custom Field, WordPress displays your mood; if
it doesn’t find the Custom Field, then WordPress doesn’t display anything.
If you followed along in the previous sections, the code in your template looks like this:

<p><strong>My Current Mood is: <?php $key=”mood”; echo get_post_meta($post->ID,
$key, true); ?></strong></p>

To make WordPress check to see whether the mood Custom Field exists, add this code to the line above your existing code:

<?php if ( get_post_meta($post->ID, ‘mood’, true) ) : ?>

Then add this line of code to the line below your existing code:

<?php endif; ?>

Put together, the lines of code in your template should look like this:

<?php if ( get_post_meta($post->ID, ‘mood’, true) ) : ?>
<p><strong>My Current Mood is: <?php $key=”mood”; echo get_post_meta($post->ID,
$key, true); ?></strong></p>
<?php endif; ?>

The first line is an IF statement and, basically, asks the question: Does the
mood metadata exist for this post? If it does, the data gets displayed. If it
doesn’t, then WordPress skips over the code, ignoring it completely so that
nothing gets displayed for the mood Custom Field. The final line of code
simply puts an end to the IF question. Refer to the “IF, ELSE” sidebar, in this chapter, to see some everyday situations that explain the IF question. Apply this statement to the code you just added to your template and you get:
IF the mood Custom Field exists, then WordPress will display it, or ELSE it won’t.

Entering the code in the template file

So that you can see how to enter the code in your template file, we use
the default WordPress theme called Twenty Ten. If you’re using a different
theme (and you can find thousands of different WordPress themes avail-
able), then you need to adapt these instructions to your particular theme.
If you really want to follow along in this chapter, activate the Twenty Ten
theme on your site, for now, just so that you can follow along and know that
you’re seeing the same code in the places we describe (you can find informa-
tion on the Twenty Ten theme and how to activate it in Book VI).
We use Lisa’s mood Custom Field as the example here. When you’re done
with these steps, WordPress displays your current mood at the bottom of
the posts to which you’ve added the mood Custom Field. Keep in mind that
this example is just one type of Custom Field that you can add to your posts
(and it’s an easy one for the purposes of introducing you to the concept).

If you’re ready to give it a go, then you’re in luck because you can follow
these steps to add the template tag, along with a little HTML code to make it
look nice, to your theme (these steps assume that you’ve already added the
mood Custom Field to your blog post and have assigned a Value to it):

1. Log in to your WordPress Dashboard.

2. Click Editor in the Appearances drop-down list.
The Edit Themes page loads in the Dashboard, as shown in Figure 5-5.
3. Locate the template files for the Twenty Ten theme.
The available templates are listed on the right side of the Edit Themes page, as shown in Figure 5-5.

4. Click Single Post in the list of templates.

The Single Post (single.php) file opens in the text editor on the left side of the screen, where you can edit the template file.
5. Scroll down and locate the template tag that looks like this: <?php
the_content() ?>.
6. On the new line underneath the preceding one, type: <p><strong>My
Current Mood is:.

<p> and <strong> open the HTML tags for paragraph and bold text, respectively; followed by the words to display in your template (My Current Mood is:).

7. Type the code that we discuss in the preceding section.
<?php $key=”mood”; echo get_post_meta($post->ID, $key, true); ?>
8. Type </strong></p>.
This code closes the HTML tags you opened in Step 6.
9. Click the Update File button.
Located at the bottom of the Edit Themes page, this step saves the
changes you made to the Single Post (single.php) file and reloads
the page with a message that says your changes have been successfully
saved.
10. View your post on your site to see your Custom Field data displayed.
The data should look just like the “My Current Mood is: Happy” shown in Figure 5-3.

The entire code, put together, should look like this in your template:

<p><strong>My Current Mood is: <?php $key=”mood”; echo get_post_meta($post->ID,
$key, true); ?></strong></p>

The code is case sensitive, which means that the words you input for the
Key in your Custom Field need to match case with the $key in the code. For example, if you input mood in the Key field, then the code needs to be lowercase, as well: $key=”mood”, if you attempt to change the case like this: $key=”Mood”, the code will not work.
You have to add this code for the mood Custom Field only one time; after you add the template function code to your template for the mood Custom Field, you can define your current mood in every post you publish to your site by using the Custom Fields interface.

Adding Custom Fields to Your Template File

If you followed along in theprevious sections and added the mood Custom
Field to your own site, notice that the data doesn’t appear on your site the
way it does on Lisa’s. To get the data to display properly, you must open the
template files and dig into the code a little bit. If the idea of digging into the
code of your template files intimidates you, you can put this section aside
and read up on WordPress themes, template files, and template tags in
Book VI.

You can add Custom Fields, in several ways, to your templates in order to
display the output of the fields you’ve set; we think the easiest way involves
using the get_post_meta(); template tag function, which looks like this:

<?php $key=”NAME”; echo get_post_meta($post->ID, $key, true); ?>

Here’s how that function breaks down:

✦ <?php: Part of the functions begins PHP. (Every template tag or function
needs to first start PHP with <?php. You can read more about basic PHP
in Book II, Chapter 3.)
✦ $key=”NAME”;: Defines the name of the key that you want to appear.
You define the Name when you add the Custom Field to your post.
✦ echo get_post_meta: Grabs the Custom Field data and displays it on
your site.

Book IV
Chapter 5

324 Adding Custom Fields to Your Template File
✦ $post->ID,: A parameter of the get_post_meta function that
dynamically defines the specific ID of the post being displayed so that WordPress knows which metadata to display.
✦ $key,: A parameter of the get_post_meta function that gets the
value of the Custom Field based on the name, as defined in the
$key=”NAME”; setting earlier in the code string.
✦ true);: A parameter of the get_post_meta function that tells
WordPress to return a single result, rather than multiple results. (By
default, this parameter is set to true; typically, don’t change it unless
you’re using multiple definitions in the Value setting of your Custom
Field.)
✦ ?>: Ends the PHP function.

Based on the preceding code, to make our mood Custom Field example, you define the key name as mood (replace the NAME in the preceding code with the word mood); it looks like this:

<?php $key=”mood”; echo get_post_meta($post->ID, $key, true); ?>

The part of the functions that says $key=”mood”; tells WordPress to return the Value for the Custom Field with the Name field of mood.

Exploring the Custom Fields Interface

The Custom Fields module appears on both the Write Post and Write Page (See Book IV, Chapters 2 and 3) pages in the WordPress Dashboard, below the Post text box.

The Custom Fields module has two different text boxes:

✦ Name: Also known as the Key, you give this name to the Custom Field
you’re planning to use. The Name needs to be unique: It’s used in the
template tag that you can read about in the section “Adding Custom
Fields to Your Template File,” later in this chapter. In Figure 5-2, you can
see that Lisa’s Custom Field has the name mood.
✦ Value: Assigned to the Custom Field name and displayed in your blog
post on your site if you use the template tag that you can also read
about in the section “Adding Custom Fields to Your Template File,”
later in this chapter. In Figure 5-2, the Value assigned to the mood (the
Custom Field name) is Happy.

 

Simply fill out the Name and Value text boxes, and then click the Add
Custom Field button to add the data to your post or page. Figure 5-2 shows
a Custom Field that Lisa added to her post with the Name of mood and with
the assigned Value Happy. In the section “Adding Custom Fields to Your
Template File,” later in this chapter, we show you the template tag you need
to add to your WordPress theme template in order to display this Custom
Field, which appears in her post like this: My Current Mood is: Happy,
shown in Figure 5-3, where the Custom Field appears at the end of Lisa’s post.
You can add multiple Custom Fields to one post. To do so, simply add the

Name and the Value of the Custom Field in the appropriate text boxes on
the Write Post page, and then click the Add Custom Field button in order to
assign the data to your post. You will do this for each Custom Field you want
to add to your post.
After you add a particular Custom Field (such as the mood Custom Field Lisa
added in Figure 5-2), you can always add it to future posts. So, you can make
a post tomorrow and use the mood Custom Field but assign a different value
to it. If tomorrow you assign the value Sad, your post displays My Current
Mood is: Sad. You can easily use just that one Custom Field on subsequent
posts. After you create a Custom Field (such as the mood Custom Field),
you can access it in a drop-down list below the Name field,
so you can easily select it again and assign a new Value to it
in the future.
Custom Fields are considered extra data, separate from the post content itself, for your blog posts, and WordPress refers to them as metadata. The Custom Field Name and Value get stored in the database in the wp_postmetadata table, which keeps track of which Names and Values are assigned to each post. See Book II, Chapter 7 for more information about the
WordPress database structure and organization of data.

Understanding Custom Fields

A WordPress template contains static pieces of data that you can count on
to appear on your site. These static items include elements such as the title,
the content, the date, and so on. But what if you want more? Say you write a
weekly book-review post on your site and want to include a listing of recent
reviews and accompanying thumbnails of the books; you can, through the
use of Custom Fields, without having to retype the list each time you do a

review. You can add literally thousands of auto-formatted pieces of data like this (such as book reviews or movie reviews, for example) by adding Custom Fields on your WordPress blog.
You create Custom Fields on a per-post or per-page basis, which means that
you can create an unlimited amount of them and add them only to certain
posts. They help you create extra data for your posts and pages by using the
Custom Fields interface, which is covered in the following section.

So, what can you do with Custom Fields? Really, the only right answer is:
Anything you want. Your imagination is your only limit when it comes to the
different types of data you can add to your posts by using Custom Fields.
Custom Fields allow the site owner the flexibility of defining certain pieces of
data for each post.
To use Custom Fields, you do need a bit of knowledge about how to navi-
gate through WordPress theme templates because you have to insert a
WordPress function tag, with specific parameters, in the body of the tem-
plate file. Book VI takes you through all the information you need to know in
order to understand WordPress themes, templates, and template tags — so
you may want to hit that minibook before you attempt to apply what we
discuss in the rest of this chapter. If you’re already comfortable and famil-
iar with WordPress templates and tags, then you probably won’t have any
trouble with this chapter at all.

Keeping Media Files Organized

If you’ve been running your blog for any length of time, you can easily forget
what files you’ve uploaded by using the WordPress uploader. Lisa used to
have to log in to her Web server via FTP and view the Uploads folder to see
what she had in there.
Now, the WordPress Media Library allows you to conveniently and easily discover which files are in your Uploads folder.
To find an image, video, or audio file you’ve already uploaded by using the file uploader and to use that file in a new post, follow these steps:

1. Click the Upload Media icon to open the File Uploader window.
2. Click the Media Library link at the top of the window.
All the files you’ve ever uploaded to your blog appear because of the
File Uploader feature (see Figure 4-3). Files you uploaded through other methods, such as FTP, don’t appear in the Media Library.
3. Select the file that you want to reuse and click the Show link.
4. In the settings menu that appears, set the options for that file: Title,
Caption, Description, Link URL, Order, Alignment, and Size.
5. Click the Insert into Post button.
The correct HTML code is inserted into the Post text box.

✦ Search media files by using a specific keyword. If you want to search
your Media Library for all files that reference kittens, then you type
the word kittens in the Search box in the upper-right side of the Media
Library page. Then click the Search Media button; the page reloads and
displays only media files that contain the keyword or tag kittens.
✦ Delete media files. To delete files, click the small white box that
appears to the left of the file’s thumbnail on the Manage Media page;
then click the Delete button, which appears at the top left of the page.
The page reloads, and the media file you just deleted is now gone.
✦ View media files. On the Manage Media page, click the thumbnail of the
file you want to view. The actual file opens in your Web browser. If you
need the URL of the file, you can copy the permalink of the file from your
browser’s address bar.

 

Podcasting with WordPress

As we explain in the introduction to this chapter, to podcast, the Web site owner provides regular episodes of an audio show that visitors can download to their computer and listen to on their favorite audio player. Think of podcasting as a weekly radio show that you tune into, except that it’s hosted on the Internet, rather than on a radio station.
In the sidebar “WordPress video and audio plugins” in this chapter, we mention

a few plugins that allow you to more easily insert audio files in your WordPress
posts and pages — however, a few plugins are dedicated to podcasting, and
they provide features to podcasters that go beyond just embedding audio files
in a Web site. Some of the more important of these features include
✦ Archives: Create an archive of your audio podcast files so that your lis-
teners can catch up on your show by listening to past episodes.
✦ RSS Feed: An RSS feed of your podcast show gives visitors the opportu-
nity to subscribe to your syndicated content so that they can be notified
when you publish future episodes.
✦ Promotion: A podcast isn’t successful without listeners, right?
Podcasters like to promote their shows by including their audio files
in the iTunes (www.apple.com/itunes) library so that when people
search iTunes for podcasts by subject, they find the podcasters’ podcasts and subscribe to them.
These three plugins go beyond just audio-file management, they’re dedicated to podcasting and all the features a podcaster is looking for:

✦ PowerPress (http://wordpress.org/extend/plugins/
powerpress): PowerPress has many of the features podcasters are
looking for, including full iTunes support; audio players; multiple file-
format support (.mp3, .m4a, .ogg, .wma, .ra, .mp4a, .m4v, .mp4v,
.mpg, .asf, .avi, .wmv, .flv, .swf, .mov, .divx, .3gp, .midi, .wav,
.aa, .pdf, .torrent, .m4b, .m4r); statistics to track the popularity of
your different podcast offerings; and tagging, categorizing, and archiving
of podcast files.
✦ Podcast Channels (http://wordpress.org/extend/plugins/
podcast-channels): WordPress provides some of the basic stuff
needed for podcasting, such as media-file embedding, archiving, and RSS feed handling. The Podcast Channels plugin gives you iTunes metadata that enables you to specify channels for your podcast files and include them in the iTunes library.
✦ Podcasting Plugin (http://wordpress.org/extend/plugins/
podcasting): Enhances the built-in WordPress audio-management
features by adding iTunes support, compatible RSS feeds, and media
players. This plugin also allows you to have multiple podcasting feeds,
in case you have different podcast shows that cover a range of different
topics.
We discuss Web hosting requirements in Book II. If you’re a podcaster and
intend to store audio files on your Web hosting account, you may need to
add increased storage and bandwidth to your account so that you don’t run
out of space or incur higher fees from your Web hosting provider. Discuss
these issues with your Web hosting provider to find out upfront what you
have to pay for increased disk space and bandwidth needs.

Inserting Audio Files into Your Blog Posts

Audio files can be music files or voice recordings, such as recordings of you speaking to your readers. These files add a nice personal touch to your blog. You can easily share audio files on your blog by using the Upload Audio feature in WordPress. After you insert an audio file in a blog post, your readers can listen to it on their computers, or download it onto an MP3 player and listen to it on their drives to work, if they want.
Click the Add Audio icon on the Edit Post or Add New Post page, and then follow these steps to upload an audio file to your blog post:

1. Click the Select Files button.
An Open dialog box appears, as shown in Figure 4-2.
2. Select the file that you want to upload and click Open (or simply
double-click the filename).
The file uploader window reappears in WordPress, which shows a progress bar while your audio file uploads. When the upload is complete, a dialog box that contains several options opens.

 

3. Type a title for the file in the Title text box.

4. Type a caption for the file in the Caption text box.
5. Type a description of the file in the Description text box.
6. Click the File URL button.
Clicking this button provides a direct link in your post to the video file
itself.
7. Click Insert into Post.
A link to the audio file is inserted into your post. WordPress doesn’t
embed an actual audio player in the post; it only inserts a link to the
audio file. Visitors click the link to open another page, where they can
play the audio file.
Some great WordPress plugins for audio-handling can enhance the function-
ality of the file uploader and help you manage audio files in your blog posts.
Check out Book VII for information on how to install and use WordPress Book IV
plugins in your blog.

Adding video from your computer

To upload and post to your blog a video from your computer, click the Add
Video icon on the Edit Post or Add New Post page. Then follow these steps:

1. Click the Choose Files to Upload button.

An Open dialog box appears.
2. Select the video file that you want to upload and click Open (or simply
double-click the filename).
The file uploader window in WordPress appears, which shows a progress bar while your video uploads. When the upload is complete, a dialog box that contains several options opens.
3. Type a title for the file in the Title text box.
4. Type a caption for the file in the Caption text box.
5. Type a description of the file in the Description text box.
6. Click the File URL button.
Clicking this button provides a direct link in your post to the video file
itself.
7. Click Insert into Post.
WordPress doesn’t embed a video player in the post, it inserts only
a link to the video; however, if you have the Auto-Embed feature acti-
vated, WordPress attempts to embed the video within a video player. If
WordPress cannot embed a video player, it displays the link that your
visitors will have to click in order to open the video in a new window to
view it.