Wednesday, November 8, 2017

Client Side Override the Site Logo's link in an SharePoint Site

In SharePoint sites that have any kind of hierarchy of subwebs, it is frequently desirable to override the logo's link behavior to link back to the root of the site collection.   There's a bunch of guidance on how to do this by overriding the master page, but not much on how to do this client-side, to avoid MasterPage manipulation.   Here's a script that helps to do this:

//update site icon link, SP overrides any direct reassignment so you have to change the existing ID
//and then create a dummy element with the existing ID to avoid future JS errors.
//read old link id
var prevId = $("#DeltaSiteLogo > a").attr('id');
//change the id
$("#" + prevId).attr({
      'id':'CustomSiteLogo',
      'title': 'Employee Portal Home',
      'href':window.location.protocol + "//" + window.location.host
});
$("#DeltaSiteLogo > a").after("<a id='" + prevId + "' href='#' style='display:none'>Dummy</a>");

You'll need jQuery to do this and I'd recommend putting this into a file and then injecting via a SiteCollection scope custom action.   Here's the simplest way to do that:

https://github.com/SharePoint/PnP-PowerShell/blob/master/Documentation/Add-PnPCustomAction.md 

Wednesday, March 29, 2017

Connect-PnPOnline : For security reasons DTD is prohibited in this XML document. error

Until today I had never received this error when trying to connect to SPO.    If you get this error there's a good chance it's related to missing records on the DNS server your machine is relying upon.  If not set, there's a good chance you're using your ISP's DNS servers, whose records may not be as up to date as others.  The quick fix (at least for me) was to alter my DNS settings to point to more reliably up-to-date DNS.   Here's a how to fix this issu (on Windows 10, if you aren't using windows 10, follow your OS instructions on updating DNS settings and then just jump to step 4 below) along with a few options for DNS settings that I tested:


  1. Click Start and type "View Network Connections.
  2. Right-Click your adapter that connects to the internet and choose properties
  3. Choose TCP/IP v4 and then click the "Properties" button
  4. At the bottom of the IP v4 properties window, select the radio button that says "Use the following DNS Server addresses" and enter in a primary and secondar DNS.
    1. You can view a recently updated list of options here:  https://www.lifewire.com/free-and-public-dns-servers-2626062 
    2. FWIW, I chose Google's, Primary: 8.8.8.8 and Secondary: 8.8.4.4
  5. Click OK out of all the windows and retry the Connect-PnP (or Connect-SPO) command.