Copyright - skrypt php i javascript

W nawiązaniu do wpisu Efki o znaczku copyright (©) umieszczanym w stopce strony i ogólnie o prawach autorskich, postanowiłem napisać prosty skrypt PHP, który rozwiązuje wspomniany u niej problem - kiedy ktoś zapomina zaktualizować datę i w roku 2010 nadal widnieje u niego na stronie przedział lat 2006-2008.

Można oczywiście w ogóle zrezygnować z daty lub z informacji o prawach autorskich, ale jeśli już to robimy, to zróbmy to porządnie.

Najprostszym sposobem jest umieszczenie w stopce informacji o prawach jedynie w odniesieniu do aktualnego roku, ale zamiast wpisywać rok ręcznie i zmieniać go co rok (lub o tym zapominać), można podać rok 'aktualny', do którego mamy dostęp dzięki obiektowi Date:

<?php echo date('Y'); ?>

Co, jeśli chcemy bardziej rozbudować naszą stopkę, na przykład o zakres lat? Na przykład, rozpoczęliśmy pisanie na blogu w roku 2007, w chwili tworzenia tego wpisu mamy rok 2010, więc chcielibyśmy dostać © 2007-2010. Napiszmy więc funkcję, która nam w tym pomoże:

<?php
function copyright($fromYear) {
  return '&copy; '.$fromYear.'-'.date('Y');
}
echo copyright(2007);
?>

Dzięki tej funkcji bez problemu zdefiniujemy nasz zakres, a wpisując 2007 jako datę początkową dostaniemy w odpowiedzi © 2007-2010. Spróbujmy to urozmaicić i dodać od razu autora, by wpis o prawach autorskich był kompletny:

<?php
function copyright($fromYear,$author) {
  return '&copy; '.$fromYear.'-'.date('Y').' '.$author;
}
echo copyright(2007,'Ender');
?>

Tak zdefiniowana funkcja wyświetli nam © 2007-2010 Ender, czyli od lewej znaczek copyright, zakres dat oraz autora. Wygląda to dobrze, ale co się stanie, jeśli ktoś wpisze złe dane? Zakres od 2070 do 2010 nie wygląda za dobrze, jeśli ktoś popełni literówkę wpisując rok 2007. Spróbujmy zabezpieczyć nasz skrypt:

<?php
function copyright($fromYear,$author) {
  $currentYear = date('Y');
  $dateRange = '';
  if($fromYear >= $currentYear)
    $dateRange = $currentYear;
  else
    $dateRange = $fromYear.'-'.$currentYear;
  return '&copy; '.$dateRange.' '.$author;
}
echo copyright(2007,'Ender');
?>

Jeśli wpisany rok jest większy lub równy aktualnemu, to wyświetlamy jedynie aktualny rok (np. 2010). Jeśli wpisany rok jest mniejszy od aktualnego, wyświetlamy zakres (np. 2007-2010). Spróbujmy zmniejszyć liczbę linijek kodu - zastosujemy skróconą formę instrukcji warunkowej if...else, która wygląda tak:

// normalny warunek:
if(warunek)
  $zmienna = 'coś';
else
  $zmienna = 'coś innego';
// skrócony warunek:
$zmienna = warunek ? 'coś' : 'coś innego';

Tak więc zamiast czterech linijek możemy to zapisać w jednej:

$dateRange = ($fromYear >= $currentYear ? $currentYear : $fromYear.'-'.$currentYear);

Możemy to jeszcze bardziej uprościć przenosząc powtarzającą się zmienną poza instrukcję warunkową:

$dateRange = ($fromYear >= $currentYear ? '' : $fromYear.'-').$currentYear;

Dzięki tym zabiegom nasza funkcja wygląda następująco:

<?php
function copyright($fromYear,$author) {
  $currentYear = date('Y');
  $dateRange = ($fromYear >= $currentYear ? '' : $fromYear.'-').$currentYear;
  return '&copy; '.$dateRange.' '.$author;
}
echo copyright(2007,'Ender');
?>

Wygląda nieźle. Chcielibyśmy, by autor był podlinkowany do strony głównej. Nie ma problemu, całość będzie wyglądać tak:

<?php
function copyright($fromYear,$author,$link) {
  $currentYear = date('Y');
  $dateRange = ($fromYear >= $currentYear ? '' : $fromYear.'-').$currentYear;
  $authorInfo = $link ? '<a href="'.$link.'">'.$author.'</a>' : $author;
  return '&copy; '.$dateRange.' '.$authorInfo;
}
echo copyright(2007,'Andrzej','');
echo copyright(2006,'Ender','http://end3r.com/');
?>

Pierwsze użycie naszej funkcji wyświetli © 2007-2010 Andrzej, natomiast drugie © 2006-2010 Ender.
Gotowe, skończyliśmy tworzyć skrypt, który za nas bedzie martwił się odpowiednim wyświetleniem zakresu dat dla praw autorskich. Oczywiście zwracany wygląd można sobie dowolnie zmodyfikować, na przykład wyświetlić najpierw autora, a później znaczek © i daty. Na przykład zmiana ostatniej linijki funkcji na return 'Copyright &copy; '.$dateRange.' by '.$authorInfo; wyświetli nam Copyright © 2007-2010 by Andrzej. Każdy może zmodyfikować powyższy skrypt dla własnych potrzeb i uzyskać zadowalający go efekt.

JavaScript
Jeśli ktoś woli użyć JavaScript zamiast PHP, to logika jest identyczna, a kod różni się jedynie szczegółami (zmienne, łączenie łańcuchów znakowych). Tak wygląda kod po zmianie języka:

<script type="text/javascript">
function copyright(fromYear,author,link) {
  var currentYear = new Date().getFullYear();
  var dateRange = (fromYear >= currentYear ? '' : fromYear +'-') + currentYear;
  var authorInfo = link ? '<a href="' + link + '">' + author + '</a>' : author;
  return '&copy; ' + dateRange + ' ' + authorInfo;
}
document.write(copyright(2006,'Ender','http://end3r.com/'));
</script>

Można go umieścić w footerze tam, gdzie mamy zamiar wyświetlić informację o prawach autorskich. Oczywiście najlepiej byłoby umieścić ten kod (bez tagów <script>) i użyć funkcję w zewnętrznym pliku .js zawierającym cały nasz kod użyty na stronie, zamiast wklejać go bezpośrednio.