Skip to content
We are an aggregator of content from Xamarin Community members. Why subscribe individually when you can subscribe to one convenient RSS feed, to see all the content generated by the community members in you news reader.
JavaScript C# HTML CSS PowerShell Shell
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update issue templates (#524) Oct 8, 2018
assets Added the Photoshop file for the profile card background (#104) Jan 18, 2017
src Fix up medium issues May 16, 2020
.gitattributes sourcedrop from readify.net Nov 16, 2016
.gitignore Remove empty MFractor feeds. Add mfractors working directory to gitig… Apr 30, 2018
CODE_OF_CONDUCT.md various changes (#15) Jan 16, 2017
LICENSE sourcedrop from readify.net Nov 16, 2016
README.md Patch 1 (#604) Aug 13, 2019
a.out hide description when bio is empty (#122) Jan 19, 2017
appveyor.yml Unit tests (#425) Feb 9, 2018
build.cake Switch to new feed without Blogmonster 2 (#636) Mar 6, 2020
build.ps1 added ci Jan 16, 2017
build.sh added weeklyxamarin (#56) Jan 17, 2017
cake.config added ci Jan 16, 2017

README.md

Welcome

Hi! Welcome to PlanetXamarin.com!

If you write about Xamarin, you belong here. You're welcome to add your blog and have it aggregated as part of our feed as long as the content you are sharing does not violate the community code of conduct.

Add yourself as an author

Author Guidelines

  • I have a valid blog & RSS URL, both using HTTPS with a valid certificate
  • Host NO malicious or offensive content on the blog (including photos, swearing, etc.)
  • Blog is active with at least 3 Xamarin related blog posts in the last 6 months
  • If the blog has mixed content (Xamarin and Personal/Non-Xamarin blogs) a filter has been applied
  • If you delete your blog you will come delete your blog from Planet Xamarin
  • Your blog may be removed at any time if any of these are broken.

How to add

To add yourself as an author you can fork this project, add yourself to the authors folder as a class, implementing the IAmACommunityMember interface. If you are doing this via the GitHub editor, don't forget to add the class to the .csproj.

The result should look something like this:

public class BruceWayne : IAmACommunityMember
{
    public string FirstName => "Bruce";
    public string LastName => "Wayne";
    public string ShortBioOrTagLine => "potentially batman";
    public string StateOrRegion => "Gotham";
    public string EmailAddress => "rescueme@planetxamarin.com";
    public string TwitterHandle => "planetxamarin";
    public string GravatarHash => "42abc1337def";
    public string GitHubHandle => "planetxamarin";
    public GeoPosition Position => new GeoPosition(47.643417, -122.126083);
    public Uri WebSite => new Uri("https://planetxamarin.com/");
    public IEnumerable<Uri> FeedUris { get { yield return new Uri("https://planetxamarin.com/rss"); } }
    public string FeedLanguageCode => "en";
}

A few things:

  • Name the class after your first and lastname with PascalCase
  • The FirstName and LastName property should resemble that same name
  • ShortBioOrTagLine property can be whatever you like. If you can't think of anything choose: 'software engineer' or 'software engineer at Microsoft'. Please keep it short, like a 140 character tweet.
  • StateOrRegion will be your geographical location, i.e.: Holland, New York, etc.
  • EmailAddress, TwitterHandle and GitHubHandle should be pretty clear, TwitterHandle without the leading @
  • Position is your latitude and longitude, this allows you to be placed on the map on the Authors page
  • The Website property can be your global website or whatever you want people to look at
  • With FeedUris you can supply one or more URIs which resemble your blogs. Your blogs should be provided in RSS (Atom) format and of course be about Xamarin.
  • And finally FeedLanguageCode specifies in what lanuage the majority of your content will be. This is used to be able to apply filters to the feed. This language code should be in ISO 639-1 format
  • If you do not want your e-mailaddress publicly available but you do want to show your Gravatar go to https://en.gravatar.com/site/check/ and get your hash! If you don't fill the hash, you will be viewed as a silhouette.

If you also do some blogging about other stuff, no worries! You're fine! Just have a look at the next section on how to filter out your Xamarin specific posts.

Just Xamarin please

Per default PlanetXamarin implements a default filter looking for Xamarin in the title and categories (tags) you have on your blog posts. This behavior can be modified by implementing IFilterMyBlogPosts, where you can implement your own filtering logic. It could be that you want to disable all filtering because your blog is solely about Xamarin. Maybe, you run a Xamarin newsletter or podcast.

public class BruceWayne : IAmACommunityMember, IFilterMyBlogPosts
{
    // ... Author properties from the above class, removed for brevity

    public bool Filter(SyndicationItem item)
    {
        // Here you filter out the given item by the criteria you want, i.e.
        // this filters out posts that do not have Xamarin in the title
        return item.Title.Text.ToLowerInvariant().Contains("xamarin");
        
        // This filters out only the posts that have the "xamarin" category
        // Not all blog posts have categories, please guard against this
        return item.Categories?.Any(c => c.Name.ToLowerInvariant().Equals("xamarin")) ?? false;
        
        // Of course you can make the checks as complicated as you want and combine some stuff
        return item.Title.Text.ToLowerInvariant().Contains("xamarin") && (item.Categories?.Any(c => c.Name.ToLowerInvariant().Equals("xamarin")) ?? false);
    }
}

A small step for an author...

A big step for mankind! Last thing that remains is submit a Pull Request to us and whenever it gets merged: hooray! You're an author now!

Don't forget to incorporate the Featured on Planet Xamarin badge on your blog and link back to us!

Featured on Planet Xamarin Badge

Enjoy all of our great content!

Of course you are more than welcome to submit other features and bugfixes as well.

Build Status

  • Azure DevOps: Build status

Acknowledgements

  • Thanks to Readify for open sourcing their employee blog aggregation platform which we forked to create PlanetXamarin. Looking for your next challenge? Readify is hiring and offers relocation services for developers from abroad.
  • Thanks to our awesome contributors and our community of authors who make this all possible.
You can’t perform that action at this time.