Custom splash page: Difference between revisions

From diaspora* project wiki
(Created page with "All you have to do is to create a <tt>app/views/home/_show.html.haml</tt> to define your own splash page for your Diaspora pod. Or <tt>app/views/home/_show.html.erb</tt> if yo...")
 
No edit summary
 
(15 intermediate revisions by 7 users not shown)
Line 1: Line 1:
All you have to do is to create a <tt>app/views/home/_show.html.haml</tt> to define your own splash page for your Diaspora pod. Or <tt>app/views/home/_show.html.erb</tt> if you prefer to write plain HTML instead of [http://haml-lang.com/ HAML]. Do not copy or overwrite <tt>app/views/home/show.html.haml</tt> (note the missing underscore)!
All you have to do is to create a <tt>app/views/home/_show.html.haml</tt> to define your own splash page for your Diaspora pod. Or <tt>app/views/home/_show.html.erb</tt> if you prefer to write plain HTML instead of [https://haml.info/ HAML]. Do not copy or overwrite <tt>app/views/home/show.html.haml</tt> (note the missing underscore) or <tt>public/default.html</tt>!
 
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 <tt>_show.html.haml</tt> would be something like:
A very basic example of a <tt>_show.html.haml</tt> would be something like:


<pre>
<pre>
#content
.text-center
  .center
  %h2 Welcome to my pod!
    %h2 Welcome to my pod!
</pre>
</pre>


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


[[File:Custom_splash_example1.png|700px]]
A detailed example of a HTML based <tt>_show.html.erb</tt> landing page would be:
<pre>
<pre>
.navbar.navbar-fixed-top
<div class="container">
   .navbar-inner
   <div class="row">
     .container-fluid
     <div class="span12 text-center">
       %a.btn.btn-navbar{"data-target" => ".nav-collapse", "data-toggle" => "collapse"}
      <h1>Welcome to diaspora*</h1>
        %span.icon-bar
       <h3>Social Networking with <em>actual</em> privacy</h3>
        %span.icon-bar
    </div>
        %span.icon-bar
  </div>
       %a.btn.btn-success.pull-left{:href => "/users/sign_in"} Login
  <div class="row">
      %a.brand{:href => "/"} Diaspora*
    <div class="span12 text-center">
      .nav-collapse
       <h2><a href="/users/sign_up">Sign up </a> or <a href="/users/sign_in">sign in</a></h2>
        %ul.nav
    </div>
          %li
  </div>
            %a{:href => "/about.html"} About
</div>
          %li
</pre>
            %a{:href => "/privacy.html"} Privacy
 
          %li
 
            %a{:href => "/terms.html"} Terms


  .subnav
[[File:Custom_splash_example2.png|700px]]
    %ul.nav.nav-pills
      %li
        %a{:href => "https://twitter.com/joindiaspora"} @joindiaspora
      %li
        %a{:href => "https://github.com/diaspora/diaspora"} GitHub
      %li
        %a{:href => "/source.tar.gz"} Code
      %li
        %a{:href => "https://github.com/diaspora/diaspora/wiki/Changelog"} What's New?
      %li
        %a{:href => "https://goo.gl/1UR7m"} Dev-Blog


 
A more complete example using the Twitter Bootstrap "Hero" template would look like the following:
  .container{:style => "padding-top: 5%;"}
    .hero-unit
      %img{:alt => "Logo", :src => "/assets/branding/logo_caps.png"}/
      %hr/
      %p
        %b You're about to change the Internet. Let's get you set up, shall we?
      %p
        %a.btn.btn-primary.btn-large{:href => "/users/sign_up"} Start an account! &raquo;
    .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 &raquo;
      .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 &raquo;
      .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 &raquo;


   %script{:src => "/js/jquery.js"}
<pre>
  %script{:src => "/js/bootstrap.js"}
.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 »
</pre>
</pre>
[[File:Custom_splash_example3.png|700px]]


Diaspora already uses [http://twitter.github.com/bootstrap/ 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 [https://github.com/czarneckid/twitter-bootstrap-examples-haml/tree/master/views here.] but will need to be tweaked similar to the one below. (Linked JS files need to be added yourself. download [http://twitter.github.com/bootstrap/ here.])
Diaspora already uses [http://twitter.github.com/bootstrap/ 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 [https://github.com/czarneckid/twitter-bootstrap-examples-haml/tree/master/views here.] but will need to be tweaked similar to the one below. (Linked JS files need to be added yourself. download [http://twitter.github.com/bootstrap/ here.])
Line 78: Line 72:


Ensure that <tt>public/</tt> doesn’t contain any <tt>index.html</tt> 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.
Ensure that <tt>public/</tt> doesn’t contain any <tt>index.html</tt> 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.


[[Category:Podmin]]
[[Category:Podmin]]

Latest revision as of 13:22, 5 October 2020

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!


Custom splash example1.png


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>


Custom splash example2.png

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 »

Custom splash example3.png


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.