VNS.Umbraco 3.0.7

VNS Umbraco

Some diffrent helper tools for Umbraco Core

Installation

Use the package manager nuget to install.

dotnet add package VNS.Umbraco

Intro

First things first, with this package, we added a custom composer that enables direct URL acces to a template

public void Compose(IUmbracoBuilder builder) {
	builder.ContentFinders().Clear();
	builder.ContentFinders()
		.Append<ContentFinderByPageIdQuery>()
		.Append<ContentFinderByUrl>()
		.Append<ContentFinderByIdPath>()

		// Add the url and template one back in here
		.Append<ContentFinderByUrlAndTemplate>()

		.Append<ContentFinderByUrlAlias>()
		.Append<ContentFinderByRedirectUrl>();
}

Init

Add this to the top of you template

// Using
@using VNS.Umbraco;

// For injection
@inject VNS.Umbraco.Helper _vns;

Util (Utility)

This contains a lot of diffrent small static methods to help you create simple code

// Get httpcontext
HttpContext ctx;

// Get appsettings (Will load from appsettings.json)
IConfigurationRoot AppSettings;

// Get connectionstring (Will return connectionstring named umbracoDbDSN)
string ConnectionString;

// Get smtp (Will return from Umbraco:CMS:Global:Smtp)
IConfigurationSection Smtp;

// Get request method
string Util.ReqMethod;

// Is request method post
bool Util.IsPost;

// Get current url
string Util.GetCurrentUrl(bool includePath = true, bool includeQueryString = false);

// Request from form/querystring
string Util.Req(string name);

// Write to body
void Util.Write(object message);

// Redirect
void Util.Redirect(string url);

// Set content type - Default is set to: application/json
void Util.SetContentType(string contentType);

// Check if dynamic object contains a key
bool Util.ContainsKey(dynamic obj, string name);

// Session
void Util.SetSession(string key, object value);
T Util.GetSession<T>(string key);
void Util.RemoveSession(string key);
void Util.ClearSession();

// Cookie
void Util.SetCookie(string key, object value, DateTime? expires = null)
T Util.GetCookie<T>(string key);
void Util.DeleteCookie(string key);

// Udi
Udi GetUdi(this IPublishedContent content);

// Render view as string
string Util.RenderViewAsString(Microsoft.AspNetCore.Html.IHtmlContent partial, System.Text.Encodings.Web.HtmlEncoder encoder);

// Files
IFormCollection Util.ReqFiles
IFormFile Util.ReqFile(string name);
bool SaveFile(IFormFile file, string path);

// Posted body
System.IO.Stream Util.ReqBody();
string Util.ReqBodyAsString();

// Convert to XDocument
XDocument Util.Json2Xml(string json, string root = "");
XDocument Util.Obj2Xml(object obj, string root = "");

// Convert to JSON
string Util.Obj2Json(object obj);
string Util.Xml2Json(string xml);

// Convert to dynamic
T Util.Xml2Dynamic<T>(string xml);
T Util.Json2Dynamic<T>(string json);
T Util.Obj2Dynamic<T>(object obj);

// Convert stream
string Util.StreamToString(System.IO.Stream stream);

// Send email (Will use smtp settings from appsettings, add from object and look for name parameter in smtp selection to use as from name if fromName parameter not set)
bool SendEmail(System.Net.Mail.MailMessage mailMessage, string fromName = "");

// Combine objects
object Util.CombineObj(object obj1, object obj2, object obj3 = null, object obj4 = null);

// Convert UnixTime to datetime
DateTime Util.DateFromUnixTime(long unixdate);

// Expose object
void Util.DrillObject(object obj);

// Clone object
T Util.CloneObj<T>(T obj);

Secy (Security)

This contains a lot of diffrent small static methods to help you create simple code

// Generate random password
string Secy.GeneratePassword(int passwordLength = 10);

// Hash
string Secy.Hash(string text, bool Use256 = false, bool Use512 = false);

// A2B
string Secy.A2B(string input);

// B2A
string Secy.B2A(string input);

// Encrypt Text
string Secy.EncryptText(string text, string secret = "");

// Decrypt Text
string Secy.DecryptText(string text, string secret = "");

// Generate JWT token
string Secy.GetToken(object payload, string serectKey = "", int expireAfterMinutes = 1440, int notValidBeforeMinutes = 0);

// Check if JWT token is valid
bool Secy.IsTokenValid(string token, string serectKey, out string message);

// Get token headers from JWT
dynamic Secy.GetTokenHeaders(string token);

// Get token payload from JWT
dynamic Secy.GetTokenPayload(string token);

Soap

// Init
var soap = new SOAP(string url);

// Get / Set properties
Dictionary<string, string> soap.Headers;

// Execute
string soap.Execute(string method, string payloadXml = "");

// Result status
int soap.StatusCode;
string soap.StatusDescription;
bool soap.IsSuccess;

Rest

// Init
var rest = new REST(string login = "", string password = "", string seperator = ":", string prefix = "Basic");

// Get / Set properties
string rest.ContentType;
string rest.Accept;
string rest.Method;
string rest.BaseUrl;
bool rest.KeepAlive;
Dictionary<string, string> rest.Headers;

// Execute 
string rest.Execute(string url, string payload = "");

// Result status
int rest.StatusCode;
string rest.StatusDescription;
bool rest.IsSuccess;

SQL

// Init
var sql = new SQL(string server, string database, string login, string password);

// Select data from SQL
var reader = sql.GetReader(string sql);

// Loop reader
while(reader.Read()){
	// Do stuff
}

// Close reader
reader.Close();

// Insert, Update, Delete etc.
void sql.Execute(string sql);

// Close sql
sql.Close();

Cookiebot

// Init
var cookiebot = new Cookiebot(string cookieName = "CookieConsent", string preferencesName = "preferences", string statisticsName = "statistics", string marketingName = "marketing");

// Properties
bool cookiebot.Necessary;
bool cookiebot.Statistics;
bool cookiebot.Marketing;
bool cookiebot.Preferences;

Log

Injection is required

_vns.Log.Trace(string message, Exception ex = null);
_vns.Log.Debug(string message, Exception ex = null);
_vns.Log.Info(string message, Exception ex = null);
_vns.Log.Warning(string message, Exception ex = null);
_vns.Log.Error(string message, Exception ex = null);
_vns.Log.Fatal(string message, Exception ex = null);

Content

Injection is required

// Create a node
IContent _vns.Content.Create(string name, int parent, string contentTypeAlias, Dictionary<string, object> keyValues = null);

// Get a node
IContent _vns.Content.Get(int id);

// Copy node
void _vns.Content.Copy(IContent content, int parentId);

// Move node
void _vns.Content.Move(IContent content, int parentId);

// Save node
void _vns.Content.Save(IContent content);

// Save and publish node
void _vns.Content.SaveAndPublish(IContent content);

// Delete node
void _vns.Content.Delete(int id);

Member

Injection is required

// Properties for current member
bool _vns.Member.IsLoggedIn;
int Id;
string Username;
string Name;
string Email;
string Comments;
DateTime? LastLoginDate;

// SignOut
void _vns.Member.SignOut();

// Validate
bool _vns.Member.Validate(string userName, string password);

// Create member
IdentityResult _vns.Member.Create(string name, string email, string password, bool isApproved = true);
IdentityResult _vns.Member.Create(string name, string email, string userName, string password, bool isApproved, string memberTypeAlias = "Member");

// IdentityResult properties
bool result.Succeeded;
IEnumerable<T> Errors;

// Login
SignInResult Login(string userName, string password) ;

// SignInResult properties
bool result.IsLockedOut;
bool result.IsNotAllowed;
bool result.RequiresTwoFactor;

// Lock / Unlock
void _vns.Member.Lock(IMember member);
void _vns.Member.Unlock(IMember member);

// Exists
bool _vns.Member.Exists(string userName);
bool _vns.Member.EmailExists(string email);

// Get a member
IMember _vns.Member.Get(); // Will return current loggedin member
IMember _vns.Member.Get(int id);
IMember _vns.Member.Get(Guid key);
IMember _vns.Member.Get(string userName);
IMember _vns.Member.GetByEmail(string email);

// Get multiple members
IEnumerable<IMember> _vns.Member.GetAllMembers(params int[] ids);
IEnumerable<IMember> _vns.Member.GetMembersByMemberType(string memberTypeid)

// Get Types
IEnumerable<IMemberType> GetAllMembertypes(params int[] ids);

// Get Roles
IEnumerable<IMemberGroup> GetAllRoles();
IEnumerable<string> GetAllRoles(int memberid);

// Generate password
string _vns.Member.GeneratePassword();

// Reset password
string _vns.Member.ResetPassword(string email);

// Change password
IdentityResult _vns.Member.ChangePassword(string oldPassword, string newPassword);

// IdentityResult properties
bool result.Succeeded;
IEnumerable<T> Errors;

// Save member
void _vns.Member.Save(IMember member);

// Delete member
void _vns.Member.Delete(int id);
void _vns.Member.Delete(string userName);
void _vns.Member.Delete(IMember member);

License

MIT