Download the PHP package wanze/seo-maestro without Composer
On this page you can find all versions of the php package wanze/seo-maestro. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download wanze/seo-maestro
More information about wanze/seo-maestro
Files in wanze/seo-maestro
Package seo-maestro
Short Description Seo Maestro allows to easily manage your page's meta data and sitemap.
License MIT
Homepage https://github.com/wanze/SeoMaestro
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package seo-maestro
Seo Maestro
A ProcessWire module helping you to manage SEO related tasks like a boss! đâī¸
- Automatically generates and maintains a XML sitemap from your pages.
- Includes a Fieldtype and Inputfield to manage sitemap settings and meta data for pages (title, description, canonical url, Opengraph, Twitter, structured data, robots etc.).
- Multi language support for the sitemap and meta data.
- Configure default values for meta data on template level and let pages inherit or overwrite them individually.
- Map existing fields to meta data, reducing the need to duplicate content for content editors.
- Live preview for content editors how the entered meta data appears on Google and Facebook.
Here is an example of all rendered meta data you will get from a SeoMaestro field:
Requirements
- ProcessWire
3.0or newer - PHP
7.0or newer
Installation
Install the module from the modules directory or with Composer:
Configuration
The Seo Maestro module offers the following configuration:
Enable sitemap generationAutomatically generates and maintains a XML sitemap file.Sitemap pathPath and filename of the sitemap relative from the ProcessWire root directory. Make sure that you have write permission to the given folder, as the module needs to write an XML file.Cache timeA time in minutes how long the sitemap should be cached.Base urlThe base url used for all page links in the sitemap and URL metatags, e.g.https://yourdomain.com. If empty, the current domain is used.Default language2-letter language code of the default language, needed to ensure a correct sitemap for multilanguage sites.
Change
sitemap.seomaestro.xmltositemap.xmlonce you checked that the sitemap file is correct. The default name reduces the risk to accidentally overwrite an already existing file.
Configure Meta Data and Sitemap Settings for Pages
The meta data and the sitemap configuration of each page is managed with the included Fieldtype.
Go ahead and create a new field of type Seo Maestro, a good name for the field is seo đ.
- Configure default meta data under Details > Default Values. For text based metatags, you may enter strings or placeholders to
map existing fields. For example, if your template contains a
lead_textfield which should be used for thedescriptionmeta tag by default, use the placeholder{lead_text}. It is also possible to combine strings and placeholders. The following example appends the company name after a page's title:{title} | acme.com. - The opengraph image tag supports placeholders as well: Simply reference an image field. If the field is holding multiple images, the first
one is used. For example,
{images}would pick the first image from theimagesfield. - Each page inherits meta tag values and sitemap configuration by default, but may override them individually when editing a page.
- Under the Input tab, configure which meta data is displayed to the content editor when editing pages. Exclude any meta data you do not need or which should not be changed by content editors. You can also exclude meta groups, e.g. exclude the Opengraph section entirely.
- The Webmaster Tools section allows you to enter Google and Bing verification codes, which are rendered as meta tags.
âšī¸ Edit the field in the context of a template to override any of the default data per template.
XML Sitemap
If enabled, the module hooks after ProcessPageView::finished to generate the XML sitemap after the request has
been handled by ProcessWire.
- The sitemap is only generated if the current user is logged in and the current page is an admin page.
- It only includes pages of templates having a Seo Maestro field, in order to read the sitemap settings.
- It includes hidden pages.
- It excludes pages not viewable for the guest user.
Do not forget to submit the sitemap to Google,
either in the Search Console or by specifying the path in a robots.txt file.
â If your installation has lot of pages and the request takes too long to generate the sitemap, or if you run into memory problems, it is better disable the automatic generation. Use the
\SeoMaestro\SitemapManagerclass to create the sitemap on your own, e.g. via CLI script.
Meta Data
Common
Common meta tags that are not managed with the fieldtype, but rendered by default.
| Tag | Description |
|---|---|
<link rel="alternate"> |
Contains the local url of each active page on multi language sites. |
<meta name="generator"> |
Let anyone know that your site is powered by ProcessWire â¤ī¸ |
Fieldtype
The following meta data is managed for each page via Seo Maestro field. Meta tags are organized in so called groups.
| Group | Tags | Description |
|---|---|---|
meta |
titledescriptionkeywordscanonicalUrl |
Holds the famous title and description tags that should be optimized for search engines. It is also possible to set a custom canonical URL which by default equals the page's url. |
opengraph |
titledescriptionimageimageAlttypeimagelocalesiteName |
Opengraph meta data is read by facebook and other social networks. By default, title and description inherit the values from the meta group. If an image is specified, the og:image:width, og:image:height and og:image:type tags are included automatically at render time. |
twitter |
cardsitecreator |
Twitter reads the Opengraph meta data as well, except for a few specific tags managed by this group. |
robots |
noIndexnoFollow |
Should robots index a page and follow its links? |
structuredData |
breadcrumb |
Whether to render structured data (JSON-LD) for breadcrumbs. |
Webmaster Tools
If you add the Google and Bing verification codes in the Webmaster Tools section when editing a field, the following meta tags are rendered additionally:
| Tag | Description |
|---|---|
<meta name="google-site-verification"> |
Contains the Google verification code. |
<meta name="msvalidate.01"> |
Contains the Bing verification code. |
Output Meta Tags
Meta tags must be rendered in the <head> region of your templates:
API
The module offers an easy-to-use API to retrieve and modify meta data and sitemap configuration for pages:
Values are always set for the current language. Switch the user's language to set values in a different language:
Available Selectors
The Seo Maestro fieldtype does not support to query meta data with selectors, e.g. seo.meta.title%=foo won't work.
All meta data is stored as JSON, allowing to add new data anytime without the need to change the database schema.
However, the module stores some useful flags whenever a page is saved, and these flags can be used in selectors:
sitemap_includeto quickly query if a page is included or excluded in the sitemap.<group>_inheritis set to1, if a page inherits all meta data of a given group.
Examples
Find all pages included in the sitemap:
Find all pages excluded from the sitemap inheriting all meta and opengraph data:
Hooks
Several hooks are available for developers to customize the behaviour of the module.
___renderMetatags
Add, remove or modify the rendered metatags of a group.
___renderSeoDataValue
Modify the value of meta data after being rendered.
___alterSeoDataForm
Customize the inputfields of the form containing the SEO data, e.g. change collapsed states or descriptions.
___sitemapAlwaysExclude
Specify pages that should never appear in the sitemap, regardless of sitemap settings on page level. The 404 page
is excluded by default.
___sitemapItems
Add or modify items in the sitemap.
Running Tests
The module includes PHPUnit based tests cases, located in the ./tests directory.
- Make sure that the dev dependencies are installed by running
composer installinsite/modules/SeoMaestro. - The tests will create pages, fields and templates. Everything should get cleaned up properly, but you should never ever run them on a production environment đ.
- Some tests expect a multi language setup to exist. To make them pass, use the multi language site profile provided by ProcessWire. Check the .travis.yml file for an automated setup.
To run the tests:
