diff --git a/Documentation/Images/ManualScreenshots/SearchEngineOptimization/add-widget.png b/Documentation/Images/ManualScreenshots/SearchEngineOptimization/add-widget.png new file mode 100644 index 0000000..76ba689 Binary files /dev/null and b/Documentation/Images/ManualScreenshots/SearchEngineOptimization/add-widget.png differ diff --git a/Documentation/Images/ManualScreenshots/SearchEngineOptimization/addDescription.png b/Documentation/Images/ManualScreenshots/SearchEngineOptimization/addDescription.png new file mode 100644 index 0000000..42f3537 Binary files /dev/null and b/Documentation/Images/ManualScreenshots/SearchEngineOptimization/addDescription.png differ diff --git a/Documentation/Images/ManualScreenshots/SearchEngineOptimization/pages-missing-description.png b/Documentation/Images/ManualScreenshots/SearchEngineOptimization/pages-missing-description.png new file mode 100644 index 0000000..a11c5d2 Binary files /dev/null and b/Documentation/Images/ManualScreenshots/SearchEngineOptimization/pages-missing-description.png differ diff --git a/Documentation/Index.rst b/Documentation/Index.rst index a890c28..444b53f 100644 --- a/Documentation/Index.rst +++ b/Documentation/Index.rst @@ -98,6 +98,7 @@ the `Official Introduction Package Page` module +* Use the pen (`Edit page properties`) in the top bar icon to edit the + page record. + +An alternative way is to use the context menu. + +* Open :guilabel:`Web > Page` module +* Right click the page you want to edit in the page tree +* Select the Edit action + +.. toctree:: + :hidden: + :glob: + + * + +.. _seo-page-properties-general: + +General tab +=========== + +.. figure:: ../Images/tab-general.png + :class: with-shadow + :alt: General Tab in the TYPO3 Backend + + `General` Tab in the TYPO3 Backend + +.. _seo-page-properties-general-title: + +Page Title +---------- + +The page title field is used for several purposes. From a SEO perspective +it is mainly used to define the default URL segment and as a fallback title, +if you do not set a specific SEO title. More information about the usage of +the title fields can be found at :ref:`title-for-search-engines`. + +.. _seo-page-properties-general-url-segment: + +URL Segment (slug) +------------------ + +The URL segment is the part of the URL the user enters to access your page. +Depending on your use case URLs have to fulfill certain criteria. + +By default the URL segment is based on the page tree and page title, but you +can override this and set it yourself. + +If you want to optimize your page for search engines, it is recommended to +have at least the keyword you want to be found on in your URL segment. +Please make sure to check other best practices with your SEO specialist. + +.. _seo-page-properties-seo: + +SEO Tab +======= + +.. _title-for-search-engines: + +Title for search engines +------------------------ + +The :guilabel:`Title for search engines` field is used for the +`...` tag of your web page. This title is used in the +search results of search engines. There are some best practices for +the value of this field. + +* Use a speaking title, which targets your audience +* If possible, use the keywords you want to be found on in the title +* Please make sure your title fits in a Google Snippet. You can use + third party extensions to help you with this. + +When no value for the :guilabel:`Title for search engines` field is defined, +it will have a fallback to the field :guilabel:`Page title`. It will show the +page title in the search results in that case. + +The title can have the name of the site as a prefix or suffix. The behaviour +of this can be defined by an integrator. + +By default the title will have the name of the site as a suffix, +separated by a dash. + +.. _seo-page-properties-description: + +Description +----------- + +The description field is important for SEO purposes. This field is used to +instruct search engines to use this text to show as a teaser of your page in +the search result snippets. With this description, you can give the user a +clear overview of the topic of this page. + +.. hint:: + + It is best practice to use at least the keywords you want to be found on in this description. Make sure the + description is not too long, so it fits in the search result snippets. + +.. seealso:: + You can use the :ref:`dashboard-widgets-missing-description` to get an + overview of all pages without a description and edit them directly. + +.. _seo-page-properties-index-page: + +Index this page +--------------- + +Defines whether the page should be indexed by a search engine or not. +Disabling indexing also removes the page from the XML sitemap. + +.. _seo-page-properties-follow-page: + +Follow this page +---------------- + +Defines whether search engines should follow the links on this page. + +.. _seo-page-properties-canonical: + +Canonical link +-------------- + +You want to avoid duplicate content because your ranking can suffer from this. +If you have duplicate content, you have to link to the origin of the content. +This can be an internal page or an external page. You can use the default link +wizard of TYPO3 to select the destination. If you don't set a canonical +link yourself, TYPO3 will generate a link to the current page. + +.. hint:: + + Avoid duplicate content warnings by supplying the original source of this content. + +.. _seo-page-properties-frequency: + +Change frequency +---------------- + +This field is used in the XML sitemap and will give search engines a hint +how often the content of your page is likely to change. + +For example: News in an archive are “never” updated, while your home page +might get “weekly” updates. + +.. hint:: + + Please be aware that this just gives a hint to search engines and + search engines can also ignore this information if they have better + information regarding the change frequency. + +.. _seo-page-properties-priority: + +Priority +-------- + +The priority is also used in the XML sitemap. Priority allows you to define +how important the page is compared to other pages on your site. The priority +is stated in a value from 0 to 1. Your most important pages can get an higher +priority as other pages. This value does not affect how important your pages +are compared to pages of other websites. All pages and records get a priority +of 0.5 by default. + +.. hint:: + + Please be aware that this just gives a hint to search engines and search + engines can also ignore this information if they think they have better + information regarding the change frequency. + +.. _seo-page-properties-social-media: + +Social media +============ + +The `social media` tab contains information which is used to enrich the snippet +that is shown when visitors share your URLs in social networks, modern browsers +etc. + +TYPO3 offers to have different content for OpenGraph (used for example by +Facebook and LinkedIn) and X (formerly Twitter) Cards. + +Both implementations allow you to set a title, a description and to provide an +image. When this information is not set manually, the social network will +decide itself what to show. Most probably it will use the information from +:ref:`title-for-search-engines` and :ref:`seo-page-properties-social-media-description`. + +.. _seo-page-properties-social-media-title: + +Title +----- + +This title can be specified to be shown as the title of the snippet preview +when your page is shared on the social network. You only have to fill this +field when you want a different title as in the search results. + +.. _seo-page-properties-social-media-description: + +Description +----------- + +Used to adjust the description of the preview snippet when your page is shared +at a social network. You only have to fill this field when you want a different +description as the description in the search results. + +.. _seo-page-properties-social-media-image: + +Image +----- + +You can specify the image that should be shown when your page is shared on a +social network. Please be aware that the different social networks need specific +dimensions for an image. TYPO3 ships with the most used dimension. If you want +to have more dimensions, please let your integrator add more dimensions. + +.. hint:: + + It is best practice to add an image for social networks so your result + will stand out and will be easily recognizable. + +.. _seo-page-properties-metadata: + +Metadata Tab +============ + +The `Metadata` tab contains a list of elements like `Abstract`, `Keywords` +and editorial information. + +Some site packages may utilize this for embedding within your frontend. They +are not output by default