# Activation Requirements
MarfeelPress has specific requirements to be able to run properly. Those requirements are classified in:
- Hard requirements errors: MarfeelPress Plugin can't be activated without those requirements.
- Soft requirements errors: Marfeel mobile experience can't be activated without those requirements.
- Soft requirements warnings: Marfeel mobile experience can be activated but those requirements should be solved to fully have Marfeel's benefits on traffic, engagement, and revenue.
# MarfeelPress hard requirements
The PHP version on the server must be v5.3 or higher.
The WordPress version on the server must be v4.7 or higher.
The XML PHP Library must be installed. MarfeelPress uses PHP’s XML manipulation libraries. While this is part of PHP by default, it can be built without it, and increasingly, we’re seeing some server environments needing a specific package installed. If you’re seeing an error message related to PHP XML functionality, please install PHP’s XML module.
# MarfeelPress soft requirements
- API REST must be accessible.
- Route for content extraction is accessible.
- CDN & Cache plugins with device detection.
- Ads.txt file must be writable.
- Blog must have at least 3 posts and should not be e-commerce or corporate site.
# API REST must be accessible
MarfeelPress serves your mobile version from our Marfeel servers. It helps you to reduce loading in your servers and get benefits from our infrastructure, serving a stunning navigation experience to your users.
To get the content in Marfeel servers, it can be extracted from two 2 different Wordpress APIs (opens new window).
At least one of the following routes must be accessible via GET and POST methods to ensure the content is available for extraction.
- rest_route: Default option.
- Syntax is
http(s)://<domain>/?rest_route=<path-to-content>. - Example:
https://modoeficaz.com/?rest_route=/
- Syntax is
- wp-json: If
rest_routedoes not return the expected result, use this endpoint instead.- Syntax is
http(s)://<domain>/wp-json<path-to-content>. - Example:
https://modoeficaz.com/wp-json/
- Syntax is
JSON format expected
The expected output for the request to any of those endpoints is a JSON object, the extraction will fail if any other format is returned.
Example:
Some WordPress plugins intercept calls to these endpoints and modify the output Marfeel receives to something other than JSON, or a malformed one.
In that case, no content will be extracted.
Common issues with non-accessible API REST
# CDN & Cache plugins with device detection
To differentiate desktop vs mobile versions and offer the mobile Marfeel experience to your users, your CDN & cache settings must have device detection. If your CDN or Cache plugins don't support device detection, we offer to do that adding automatically a javascript code called garda-sync.js. If your plugin has the option to use server-side device detection but is not correctly configured, MarfeelPress offers to configure it automatically.
Common CDN & Cache plugins that need special settings to differentiate desktop and mobile users
# Ads.txt file must be writable
Ads.txt specifies a mechanism for publishers to list their authorized digital sellers, to fight against fraud and misrepresented domains. We need access to write ads.txt in the root of your WordPress to get always your ads.txt updated with the Marfeel digital sellers and not losing revenue.
If you see a message alerting that MarfeelPress has no access to ads.txt, please check file permissions. If you are not a tech profile, maybe this link can help you: How to view and change file permissions with Filezilla (opens new window)
# Blog must have at least 3 posts and should not be e-commerce or corporate site
MarfeelPress is publisher-oriented and only works with sites that have at least 3 articles published. If you are installing MarfeelPress in a WordPress with no content, create at least 3 posts before activating the plugin. For the same reason, e-commerce sites or landing pages can't be marfeelized.