Custom splash page

From diaspora* project wiki
Jump to: navigation, search
Languages

English · العربية · čeština · Deutsch · Ελληνικά · Esperanto · español · suomi · français · italiano · 日本語 · Nederlands · polski · português · português do Brasil · русский · українська · 中文

All you have to do is to create a app/views/home/_show.html.haml to define your own splash page for your Diaspora pod. Or app/views/home/_show.html.erb if you prefer to write plain HTML instead of HAML. Do not copy or overwrite app/views/home/show.html.haml (note the missing underscore) or public/default.html!

If you create or change this file, be sure to restart Diaspora, you will get server errors or simply no effect otherwise.

A very basic example of a _show.html.haml would be something like:

.text-center
  %h2 Welcome to my pod!


screenshot


A detailed example of a HTML based _show.html.erb landing page would be:

<div class="container">
  <div class="row">
    <div class="span12 text-center">
      <h1>Welcome to diaspora*</h1>
      <h3>Social Networking with <em>actual</em> privacy</h3>
    </div>
  </div>
  <div class="row">
    <div class="span12 text-center">
      <h2><a href="/users/sign_up">Sign up </a> or <a href="/users/sign_in">sign in</a></h2>
    </div>
  </div>
</div>


screenshot

A more complete example using the Twitter Bootstrap "Hero" template would look like the following:

.container{style: "padding-top: 5%;"}
  .hero-unit
    = image_tag "branding/logo.png"
    %hr/
    %p  
      %b You're about to change the Internet. Let's get you set up, shall we? 
    %p  
      = link_to "Start an account! »", new_user_registration_path, class: "btn btn-primary btn-large"
  .row
    .span4
      %h2 Heading
      %p Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh.
      %p  
        %a.btn{:href => "#"} View details »
    .span4
      %h2 Heading
      %p Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum ni. 
      %p  
        %a.btn{:href => "#"} View details »
    .span4
      %h2 Heading
      %p Donec sed odio dui. Cras justo odio, dapibus ac facilisis in, egestas eget quam. Vestibulum id ligula porta felis.
      %p  
        %a.btn{:href => "#"} View details »

screenshot


Diaspora already uses Bootstrap CSS so no need to add it yourself, and examples of use are readily available in the previous link. More examples can be found here. but will need to be tweaked similar to the one below. (Linked JS files need to be added yourself. download here.)

Notice the examples above do not include the “head” & “html” elements, those are rendered by Diaspora. For your landing page you just need to provide the body section, and anything else you chose to include.

Ensure that public/ doesn’t contain any index.html or another file that would be used as index file by your Webserver. If such a file exists it’s given precedence by your Webserver and can break the log in.