Planet Drupal is an aggregated list of feeds about Drupal from around the web. It provides a place for interesting content from around the community that may not fit the existing topical sections of Drupal.org, Groups.drupal.org, and other official forums. Its purpose is the sharing of useful and relevant Drupal-related knowledge; posts that are aggregated on the planet should help others learn details about Drupal that they might not otherwise encounter.
Content on Planet Drupal is discarded after 16 weeks.
Content that's great for Planet Drupal :
- How-tos, guides, and tutorials that highlight how to use Drupal effectively.
- Module, theme, profile, and distribution announcements, preferably with some discussion or background.
- Case studies that highlight how Drupal was used on a project.
- Slides and presentations from Drupal-related talks, or notes from a past presentation.
- Community news, like progress updates on an in-progress Drupal initiative or project.
- Posts should be in English since that's the language used on Drupal.org.
- Like all interactions with the Drupal community, posts to the Planet should follow the Drupal Code of Conduct.
Content that doesn't fit Planet Drupal:
- Press releases. These can be posted into the News and Announcements forum.
- Job announcements and hiring announcements. It's fine to mention a career change in the context of another post, but remember that Drupal Planet isn't LinkedIn. Job postings can be posted into the Jobs page.
- General web development and programming posts that only mention Drupal in passing.
- "I Love Drupal!" posts that don’t provide valuable, actionable content to readers.
Other places for special Drupal-related content
- Announcements about Drupal-related events can be posted on the groups.drupal.org events page.
- Job openings and resumes can be posted on the groups.drupal.org jobs page.
- Case studies explaining how a particular Drupal site was built can be submitted in the Drupal.org Case Studies section.
How to get your feed to the Planet:
If you have content fitting the requirements above, then here are the next steps.
- You must have an RSS feed that contains only content appropriate for Drupal Planet. If your site uses Drupal, you can create a "Drupal Planet" taxonomy term and use it to tag any content you want to appear on the Planet. Drupal automatically creates an RSS feed for each taxonomy term, and you can submit that term’s feed URL in your Drupal Planet application. Alternatively, you can use the Drupal Planet feature module, which uses Flag and Views modules to create the feed. If you are not using Drupal, you will need to make sure your site can create a feed just for your Planet content.
- Your feed must have at least two posts already so we can evaluate the content and make sure it is appropriate for the Planet.
- Your feed must pass source code validation, since Drupal's aggregator module is very strict about parsing feed source code.
- It is recommended that you trim, or use a summary for your feed content between 600 and 1000 characters. Due to the number of posts on the Planet, this will make it more pleasant for readers to find what is interesting for them without having to scroll page after page.
- It is recommended that you enable reader comments for content that appears on Drupal Planet. Because Planet content is intended to increase communication and connection in the Drupal community, dialogue and feedback are important.
- It is strongly recommended that you avoid relative URLs to images in your posts. They won't display for people reading your post on drupal.org (this problem is mitigated if you provide a teasered feed) and is generally discouraged.
- Once your feed meets the above requirements, create an issue in the Drupal.org Content project asking to be added to the Planet. Remember to include the link to your feed, as well as the name you would like in the listing (e.g. Jane Doe or My Company Name).
A feed may be removed from the Planet if:
- it does not meet the content guidelines stated above
- it violates the Drupal Trademark and Logo Policy
- it contains spam, is hacked or posts are offensive
- it no longer works or no longer Drupal specific
- it hasn't been updated in a year
If you find a post on Planet Drupal that you feel is inappropriate or in violation of the content requirements above, create an issue for it in the Drupal.org Content project. Please do not leave comments on the article itself telling the author that his/her post is not welcome on Planet Drupal: the Drupal Planet moderators will look into the issue and determine whether the violation merits a warning or removal from the Planet feed.
Feed owners who disagree with a decision can appeal by creating a followup issue in the Drupal.org Content project. The appeal will be discussed and voted on by the Drupal Planet content moderators, but their decision will be final.
Important issue for blogs hosted on github
You NEED to read through this issue and make some changes to your set-up if your blog is hosted on github.