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.
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.
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 => "[email protected]";
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:
FirstName
and LastName
property should resemble that same nameShortBioOrTagLine
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 pageWebsite
property can be your global website or whatever you want people to look atFeedUris
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.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 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.
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 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!
Enjoy all of our great content!
Of course you are more than welcome to submit other features and bugfixes as well.